diff options
| author | Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> | 2022-07-15 22:21:34 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-07-15 22:21:34 (GMT) |
| commit | 734c8b7e55e37883af738198dc52fbf5011962c6 (patch) | |
| tree | 354270cf4e891fb6a77469efece7a56943b01359 | |
| parent | 8dc4de3aafed9aceaa904206f757f11bb682999b (diff) | |
| download | cpython-734c8b7e55e37883af738198dc52fbf5011962c6.zip cpython-734c8b7e55e37883af738198dc52fbf5011962c6.tar.gz cpython-734c8b7e55e37883af738198dc52fbf5011962c6.tar.bz2 | |
Add additional pointers to pathlib's mapping to os.path functions (GH-94828)
* Add additional pointers to pathlib's mapping to os.path functions
os.path.splitext has a somewhat quirky signature since it mixes the path and filename components but I wanted the documentation to mention `PurePath.stem` as the natural counterpart to `PurePath.suffix` for the common use of `os.path.splitext` to turn "file.py" into "file" and "py".
Technically this could have some discussion of how to handle the parent directory hierarchy but that seems a bit out of keeping with the spirit of this table so I omitted mentioning `PurePath.parents` here.
* Update Doc/library/pathlib.rst
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit 3789c635772fbdeb5d0fc32aa811fd6b1d935a60)
Co-authored-by: Chris Adams <chris@improbable.org>
| -rw-r--r-- | Doc/library/pathlib.rst | 3 |
1 files changed, 2 insertions, 1 deletions
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst index c4fe645..5012150 100644 --- a/Doc/library/pathlib.rst +++ b/Doc/library/pathlib.rst @@ -1319,7 +1319,8 @@ Below is a table mapping various :mod:`os` functions to their corresponding :func:`os.path.basename` :data:`PurePath.name` :func:`os.path.dirname` :data:`PurePath.parent` :func:`os.path.samefile` :meth:`Path.samefile` -:func:`os.path.splitext` :data:`PurePath.suffix` +:func:`os.path.splitext` :data:`PurePath.stem` and + :data:`PurePath.suffix` ==================================== ============================== .. rubric:: Footnotes |