From b6e66ebdf76c56b4a893c0687f91d1e6dd9cac2d Mon Sep 17 00:00:00 2001 From: Eli Bendersky Date: Thu, 28 Nov 2013 06:53:05 -0800 Subject: [PATCH] Some minor clarifications in the documentation of pathlib + inheritance diagram --- Doc/library/pathlib-inheritance.png | Bin 0 -> 11280 bytes Doc/library/pathlib.rst | 148 +++++++++++++++------------- 2 files changed, 80 insertions(+), 68 deletions(-) create mode 100644 Doc/library/pathlib-inheritance.png diff --git a/Doc/library/pathlib-inheritance.png b/Doc/library/pathlib-inheritance.png new file mode 100644 index 0000000000000000000000000000000000000000..b81c3deb6049d83051337776fe5c4f3de751e1cb GIT binary patch literal 11280 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 H*xvmghTl=r literal 0 HcmV?d00001 diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst index d4e08629d8..a8c1dc9e80 100644 --- a/Doc/library/pathlib.rst +++ b/Doc/library/pathlib.rst @@ -9,15 +9,27 @@ .. versionadded:: 3.4 - This module offers classes representing filesystem paths with semantics appropriate for different operating systems. Path classes are divided between :ref:`pure paths `, which provide purely computational operations without I/O, and :ref:`concrete paths `, which inherit from pure paths but also provide I/O operations. -The main point of entry is the :class:`Path` class, which will instantiate -a :ref:`concrete path ` for the current platform. +.. image:: pathlib-inheritance.png + :align: center + +If you've never used this module before or just aren't sure which class is +right for your task, :class:`Path` is most likely what you need. It instantiates +a :ref:`concrete path ` for the platform the code is running on. + +Pure paths are useful in some special cases; for example: + +#. If you want to manipulate Windows paths on a Unix machine (or vice versa). + You cannot instantiate a :class:`WindowsPath` when running on Unix, but you + can instantiate :class:`PureWindowsPath`. +#. You want to make sure that your code only manipulates paths without actually + accessing the OS. In this case, instantiating one of the pure classes may be + useful since those simply don't have any OS-accessing operations. .. note:: This module has been included in the standard library on a @@ -86,82 +98,78 @@ Pure path objects provide path-handling operations which don't actually access a filesystem. There are three ways to access these classes, which we also call *flavours*: +.. class:: PurePath(*pathsegments) -.. class:: PurePosixPath - - A subclass of :class:`PurePath`, this path flavour represents non-Windows - filesystem paths:: - - >>> PurePosixPath('/etc') - PurePosixPath('/etc') + A generic class that represents the system's path flavour (instantiating + it creates either a :class:`PurePosixPath` or a :class:`PureWindowsPath`):: -.. class:: PureWindowsPath + >>> PurePath('setup.py') # Running on a Unix machine + PurePosixPath('setup.py') - A subclass of :class:`PurePath`, this path flavour represents Windows - filesystem paths:: + Each element of *pathsegments* can be either a string or bytes object + representing a path segment; it can also be another path object:: - >>> PureWindowsPath('c:/Program Files/') - PureWindowsPath('c:/Program Files') + >>> PurePath('foo', 'some/path', 'bar') + PurePosixPath('foo/some/path/bar') + >>> PurePath(Path('foo'), Path('bar')) + PurePosixPath('foo/bar') -.. class:: PurePath + When *pathsegments* is empty, the current directory is assumed:: - A generic class that represents the system's path flavour (instantiating - it creates either a :class:`PurePosixPath` or a :class:`PureWindowsPath`):: + >>> PurePath() + PurePosixPath('.') - >>> PurePath('setup.py') - PurePosixPath('setup.py') + When several absolute paths are given, the last is taken as an anchor + (mimicking :func:`os.path.join`'s behaviour):: + >>> PurePath('/etc', '/usr', 'lib64') + PurePosixPath('/usr/lib64') + >>> PureWindowsPath('c:/Windows', 'd:bar') + PureWindowsPath('d:bar') -Regardless of the system you're running on, you can instantiate all of -these classes, since they don't provide any operation that does system calls. + However, in a Windows path, changing the local root doesn't discard the + previous drive setting:: + >>> PureWindowsPath('c:/Windows', '/Program Files') + PureWindowsPath('c:/Program Files') -Constructing paths -^^^^^^^^^^^^^^^^^^ + Spurious slashes and single dots are collapsed, but double dots (``'..'``) + are not, since this would change the meaning of a path in the face of + symbolic links:: -Path constructors accept an arbitrary number of positional arguments. -When called without any argument, a path object points to the current -directory:: + >>> PurePath('foo//bar') + PurePosixPath('foo/bar') + >>> PurePath('foo/./bar') + PurePosixPath('foo/bar') + >>> PurePath('foo/../bar') + PurePosixPath('foo/../bar') - >>> PurePath() - PurePosixPath('.') + (a naïve approach would make ``PurePosixPath('foo/../bar')`` equivalent + to ``PurePosixPath('bar')``, which is wrong if ``foo`` is a symbolic link + to another directory) -Any argument can be a string or bytes object representing an arbitrary number -of path segments, but it can also be another path object:: +.. class:: PurePosixPath(*pathsegments) - >>> PurePath('foo', 'some/path', 'bar') - PurePosixPath('foo/some/path/bar') - >>> PurePath(Path('foo'), Path('bar')) - PurePosixPath('foo/bar') + A subclass of :class:`PurePath`, this path flavour represents non-Windows + filesystem paths:: -When several absolute paths are given, the last is taken as an anchor -(mimicking :func:`os.path.join`'s behaviour):: + >>> PurePosixPath('/etc') + PurePosixPath('/etc') - >>> PurePath('/etc', '/usr', 'lib64') - PurePosixPath('/usr/lib64') - >>> PureWindowsPath('c:/Windows', 'd:bar') - PureWindowsPath('d:bar') + *pathsegments* is specified similarly to :class:`PurePath`. -However, in a Windows path, changing the local root doesn't discard the -previous drive setting:: +.. class:: PureWindowsPath(*pathsegments) - >>> PureWindowsPath('c:/Windows', '/Program Files') - PureWindowsPath('c:/Program Files') + A subclass of :class:`PurePath`, this path flavour represents Windows + filesystem paths:: -Spurious slashes and single dots are collapsed, but double dots (``'..'``) -are not, since this would change the meaning of a path in the face of -symbolic links:: + >>> PureWindowsPath('c:/Program Files/') + PureWindowsPath('c:/Program Files') - >>> PurePath('foo//bar') - PurePosixPath('foo/bar') - >>> PurePath('foo/./bar') - PurePosixPath('foo/bar') - >>> PurePath('foo/../bar') - PurePosixPath('foo/../bar') + *pathsegments* is specified similarly to :class:`PurePath`. -(a naïve approach would make ``PurePosixPath('foo/../bar')`` equivalent -to ``PurePosixPath('bar')``, which is wrong if ``foo`` is a symbolic link -to another directory) +Regardless of the system you're running on, you can instantiate all of +these classes, since they don't provide any operation that does system calls. General properties @@ -524,8 +532,18 @@ Concrete paths are subclasses of the pure path classes. In addition to operations provided by the latter, they also provide methods to do system calls on path objects. There are three ways to instantiate concrete paths: +.. class:: Path(*pathsegments) + + A subclass of :class:`PurePath`, this class represents concrete paths of + the system's path flavour (instantiating it creates either a + :class:`PosixPath` or a :class:`WindowsPath`):: + + >>> Path('setup.py') + PosixPath('setup.py') + + *pathsegments* is specified similarly to :class:`PurePath`. -.. class:: PosixPath +.. class:: PosixPath(*pathsegments) A subclass of :class:`Path` and :class:`PurePosixPath`, this class represents concrete non-Windows filesystem paths:: @@ -533,7 +551,9 @@ calls on path objects. There are three ways to instantiate concrete paths: >>> PosixPath('/etc') PosixPath('/etc') -.. class:: WindowsPath + *pathsegments* is specified similarly to :class:`PurePath`. + +.. class:: WindowsPath(*pathsegments) A subclass of :class:`Path` and :class:`PureWindowsPath`, this class represents concrete Windows filesystem paths:: @@ -541,15 +561,7 @@ calls on path objects. There are three ways to instantiate concrete paths: >>> WindowsPath('c:/Program Files/') WindowsPath('c:/Program Files') -.. class:: Path - - A subclass of :class:`PurePath`, this class represents concrete paths of - the system's path flavour (instantiating it creates either a - :class:`PosixPath` or a :class:`WindowsPath`):: - - >>> Path('setup.py') - PosixPath('setup.py') - + *pathsegments* is specified similarly to :class:`PurePath`. You can only instantiate the class flavour that corresponds to your system (allowing system calls on non-compatible path flavours could lead to -- 2.49.0