Issue #19776: Add a expanduser() method on Path objects.

Patch by Serhiy.

1 files changed, 12 insertions, 3 deletions

diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 0942b21df3..c796cf4360 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -670,6 +670,18 @@ call fails (for example because the path doesn't exist):
       symlink *points to* an existing file or directory.
 
 
+.. method:: Path.expanduser()
+
+   Return a new path with expanded ``~`` and ``~user`` constructs,
+   as returned by :meth:`os.path.expanduser`::
+
+      >>> p = PosixPath('~/films/Monty Python')
+      >>> p.expanduser()
+      PosixPath('/home/eric/films/Monty Python')
+
+   .. versionadded:: 3.5
+
+
 .. method:: Path.glob(pattern)
 
    Glob the given *pattern* in the directory represented by this path,
@@ -1003,7 +1015,4 @@ call fails (for example because the path doesn't exist):
       >>> p.read_text()
       'Text file contents'
 
-   An existing file of the same name is overwritten.  The optional parameters
-   have the same meaning as in :func:`open`.
-
    .. versionadded:: 3.5