mirrors/cpython
0
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2024-11-24 02:15:30 +08:00
Code Issues Packages Projects Releases Wiki Activity

gh-86610: Use attribute directive in docs for pathlib.PurePath (#101114)

Browse Source
This commit is contained in:
Barney Gale 2023-01-20 22:13:58 +00:00 committed by GitHub
parent 9a155138c5
commit 01093b8203
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 14 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
Doc/library/pathlib.rst
View File

@ -266,7 +266,7 @@ Accessing individual parts
To access the individual "parts" (components) of a path, use the following
property:
.. data:: PurePath.parts
.. attribute:: PurePath.parts
A tuple giving access to the path's various components::
@ -290,7 +290,7 @@ Methods and properties
Pure paths provide the following methods and properties:
.. data:: PurePath.drive
.. attribute:: PurePath.drive
A string representing the drive letter or name, if any::
@ -306,7 +306,7 @@ Pure paths provide the following methods and properties:
>>> PureWindowsPath('//host/share/foo.txt').drive
'\\\\host\\share'
.. data:: PurePath.root
.. attribute:: PurePath.root
A string representing the (local or global) root, if any::
@ -342,7 +342,7 @@ Pure paths provide the following methods and properties:
an implementation-defined manner, although more than two leading slashes
shall be treated as a single slash."*
.. data:: PurePath.anchor
.. attribute:: PurePath.anchor
The concatenation of the drive and root::
@ -356,7 +356,7 @@ Pure paths provide the following methods and properties:
'\\\\host\\share\\'
.. data:: PurePath.parents
.. attribute:: PurePath.parents
An immutable sequence providing access to the logical ancestors of
the path::
@ -372,7 +372,7 @@ Pure paths provide the following methods and properties:
.. versionchanged:: 3.10
The parents sequence now supports :term:`slices <slice>` and negative index values.
.. data:: PurePath.parent
.. attribute:: PurePath.parent
The logical parent of the path::
@ -401,7 +401,7 @@ Pure paths provide the following methods and properties:
symlinks and eliminate ``".."`` components.
.. data:: PurePath.name
.. attribute:: PurePath.name
A string representing the final path component, excluding the drive and
root, if any::
@ -417,7 +417,7 @@ Pure paths provide the following methods and properties:
''
.. data:: PurePath.suffix
.. attribute:: PurePath.suffix
The file extension of the final component, if any::
@ -429,7 +429,7 @@ Pure paths provide the following methods and properties:
''
.. data:: PurePath.suffixes
.. attribute:: PurePath.suffixes
A list of the path's file extensions::
@ -441,7 +441,7 @@ Pure paths provide the following methods and properties:
[]
.. data:: PurePath.stem
.. attribute:: PurePath.stem
The final path component, without its suffix::
@ -1446,11 +1446,11 @@ Below is a table mapping various :mod:`os` functions to their corresponding
:meth:`Path.group`
:func:`os.path.isabs` :meth:`PurePath.is_absolute`
:func:`os.path.join` :func:`PurePath.joinpath`
:func:`os.path.basename` :data:`PurePath.name`
:func:`os.path.dirname` :data:`PurePath.parent`
:func:`os.path.basename` :attr:`PurePath.name`
:func:`os.path.dirname` :attr:`PurePath.parent`
:func:`os.path.samefile` :meth:`Path.samefile`
:func:`os.path.splitext` :data:`PurePath.stem` and
:data:`PurePath.suffix`
:func:`os.path.splitext` :attr:`PurePath.stem` and
:attr:`PurePath.suffix`
==================================== ==============================
.. rubric:: Footnotes