The "parts" property now simply returns a tuple (the slightly magic slicing behaviour is gone)
This commit is contained in:
parent
ea0c8221a0
commit
ee543c9e5c
21
pep-0428.txt
21
pep-0428.txt
|
@ -216,7 +216,7 @@ Some examples::
|
||||||
>>> p.root
|
>>> p.root
|
||||||
'/'
|
'/'
|
||||||
>>> p.parts
|
>>> p.parts
|
||||||
<PosixPath.parts: ['/', 'home', 'antoine', 'pathlib', 'setup.py']>
|
('/', 'home', 'antoine', 'pathlib', 'setup.py')
|
||||||
>>> p.relative_to('/home/antoine')
|
>>> p.relative_to('/home/antoine')
|
||||||
PosixPath('pathlib/setup.py')
|
PosixPath('pathlib/setup.py')
|
||||||
>>> p.exists()
|
>>> p.exists()
|
||||||
|
@ -469,29 +469,18 @@ ValueError is raised if the method cannot return a meaningful value::
|
||||||
Sequence-like access
|
Sequence-like access
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
The ``parts`` property provides read-only sequence access to a path object::
|
The ``parts`` property returns a tuple providing read-only sequence access
|
||||||
|
to a path's components::
|
||||||
|
|
||||||
>>> p = PurePosixPath('/etc/init.d')
|
>>> p = PurePosixPath('/etc/init.d')
|
||||||
>>> p.parts
|
>>> p.parts
|
||||||
<PurePosixPath.parts: ['/', 'etc', 'init.d']>
|
('/', 'etc', 'init.d')
|
||||||
|
|
||||||
Simple indexing returns the invidual path component as a string, while
|
|
||||||
slicing returns a new path object constructed from the selected components::
|
|
||||||
|
|
||||||
>>> p.parts[-1]
|
|
||||||
'init.d'
|
|
||||||
>>> p.parts[:-1]
|
|
||||||
PurePosixPath('/etc')
|
|
||||||
|
|
||||||
Windows paths handle the drive and the root as a single path component::
|
Windows paths handle the drive and the root as a single path component::
|
||||||
|
|
||||||
>>> p = PureWindowsPath('c:/setup.py')
|
>>> p = PureWindowsPath('c:/setup.py')
|
||||||
>>> p.parts
|
>>> p.parts
|
||||||
<PureWindowsPath.parts: ['c:\\', 'setup.py']>
|
('c:\\', 'setup.py')
|
||||||
>>> p.root
|
|
||||||
'\\'
|
|
||||||
>>> p.parts[0]
|
|
||||||
'c:\\'
|
|
||||||
|
|
||||||
(separating them would be wrong, since ``C:`` is not the parent of ``C:\\``).
|
(separating them would be wrong, since ``C:`` is not the parent of ``C:\\``).
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue