[Python-checkins] bpo-31972: Improve docstrings for pathlib classes (GH-5310)
Miss Islington (bot)
webhook-mailer at python.org
Sun Feb 18 19:37:03 EST 2018
https://github.com/python/cpython/commit/5c81ed49412e41a671283cdb4c297dab52f5b7c5
commit: 5c81ed49412e41a671283cdb4c297dab52f5b7c5
branch: 3.6
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2018-02-18T16:37:00-08:00
summary:
bpo-31972: Improve docstrings for pathlib classes (GH-5310)
(cherry picked from commit dfa015cf77a148d229ddc0a5b063562c9f9664f2)
Co-authored-by: chason <chason at gmail.com>
files:
A Misc/NEWS.d/next/Documentation/2018-01-25-14-23-12.bpo-31972.w1m_8r.rst
M Lib/pathlib.py
diff --git a/Lib/pathlib.py b/Lib/pathlib.py
index 48b566d9295f..44788c02c2f3 100644
--- a/Lib/pathlib.py
+++ b/Lib/pathlib.py
@@ -600,7 +600,9 @@ def __repr__(self):
class PurePath(object):
- """PurePath represents a filesystem path and offers operations which
+ """Base class for manipulating paths without I/O.
+
+ PurePath represents a filesystem path and offers operations which
don't imply any actual filesystem I/O. Depending on your system,
instantiating a PurePath will return either a PurePosixPath or a
PureWindowsPath object. You can also instantiate either of these classes
@@ -955,11 +957,21 @@ def match(self, path_pattern):
class PurePosixPath(PurePath):
+ """PurePath subclass for non-Windows systems.
+
+ On a POSIX system, instantiating a PurePath should return this object.
+ However, you can also instantiate it directly on any system.
+ """
_flavour = _posix_flavour
__slots__ = ()
class PureWindowsPath(PurePath):
+ """PurePath subclass for Windows systems.
+
+ On a Windows system, instantiating a PurePath should return this object.
+ However, you can also instantiate it directly on any system.
+ """
_flavour = _windows_flavour
__slots__ = ()
@@ -968,6 +980,14 @@ class PureWindowsPath(PurePath):
class Path(PurePath):
+ """PurePath subclass that can make system calls.
+
+ Path represents a filesystem path but unlike PurePath, also offers
+ methods to do system calls on path objects. Depending on your system,
+ instantiating a Path will return either a PosixPath or a WindowsPath
+ object. You can also instantiate a PosixPath or WindowsPath directly,
+ but cannot instantiate a WindowsPath on a POSIX system or vice versa.
+ """
__slots__ = (
'_accessor',
'_closed',
@@ -1422,9 +1442,17 @@ def expanduser(self):
class PosixPath(Path, PurePosixPath):
+ """Path subclass for non-Windows systems.
+
+ On a POSIX system, instantiating a Path should return this object.
+ """
__slots__ = ()
class WindowsPath(Path, PureWindowsPath):
+ """Path subclass for Windows systems.
+
+ On a Windows system, instantiating a Path should return this object.
+ """
__slots__ = ()
def owner(self):
diff --git a/Misc/NEWS.d/next/Documentation/2018-01-25-14-23-12.bpo-31972.w1m_8r.rst b/Misc/NEWS.d/next/Documentation/2018-01-25-14-23-12.bpo-31972.w1m_8r.rst
new file mode 100644
index 000000000000..e0361df578b3
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2018-01-25-14-23-12.bpo-31972.w1m_8r.rst
@@ -0,0 +1 @@
+Improve docstrings for `pathlib.PurePath` subclasses.
More information about the Python-checkins
mailing list