mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-07-24 19:54:21 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

docs: clarify Path.suffix (GH-106650)

Browse source
This commit is contained in:
Ned Batchelder 2023-07-13 12:24:54 -07:00 • committed by GitHub
parent 8d2f3c36ca
commit f014f1567c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 6 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

5
Doc/library/pathlib.rst
View file

@ -432,7 +432,7 @@ Pure paths provide the following methods and properties:
.. attribute:: PurePath.suffix
The file extension of the final component, if any::
The last dot-separated portion of the final component, if any::
>>> PurePosixPath('my/library/setup.py').suffix
'.py'
@ -441,10 +441,11 @@ Pure paths provide the following methods and properties:
>>> PurePosixPath('my/library').suffix
''
This is commonly called the file extension.
.. attribute:: PurePath.suffixes
A list of the path's file extensions::
A list of the path's suffixes, often called file extensions::
>>> PurePosixPath('my/library.tar.gar').suffixes
['.tar', '.gar']

5
Doc/library/zipfile.rst
View file

@ -577,7 +577,8 @@ Path objects are traversable using the ``/`` operator or ``joinpath``.
.. data:: Path.suffix
The file extension of the final component.
The last dot-separated portion of the final component, if any.
This is commonly called the file extension.
.. versionadded:: 3.11
Added :data:`Path.suffix` property.
@ -591,7 +592,7 @@ Path objects are traversable using the ``/`` operator or ``joinpath``.
.. data:: Path.suffixes
A list of the path’s file extensions.
A list of the path’s suffixes, commonly called file extensions.
.. versionadded:: 3.11
Added :data:`Path.suffixes` property.