Docs for issue #22570.

This commit is contained in:
Guido van Rossum 2016-01-06 11:15:52 -08:00
parent e428231539
commit df85946e8a
1 changed files with 17 additions and 0 deletions

View File

@ -365,6 +365,23 @@ Pure paths provide the following methods and properties:
''
.. data:: PurePath.path
A string representing the full path::
>>> PurePosixPath('my/library/setup.py').path
'my/library/setup.py'
This always returns the same value as ``str(p)``; it is included to
serve as a one-off protocol. Code that wants to support both
strings and ``pathlib.Path`` objects as filenames can write
``arg = getattr(arg, 'path', arg)`` to get the path as a string.
This can then be passed to various system calls or library
functions that expect a string. Unlike the alternative
``arg = str(arg)``, this will still raise an exception if an object
of some other type is given by accident.
.. data:: PurePath.suffix
The file extension of the final component, if any::