mirror of https://github.com/python/cpython
bpo-24899: Add comparison table for os.path -> pathlib (GH-1753)
This commit is contained in:
parent
7a99625e0d
commit
ae8750bca8
|
@ -1055,3 +1055,36 @@ call fails (for example because the path doesn't exist):
|
||||||
'Text file contents'
|
'Text file contents'
|
||||||
|
|
||||||
.. versionadded:: 3.5
|
.. versionadded:: 3.5
|
||||||
|
|
||||||
|
Correspondence to tools in the :mod:`os` module
|
||||||
|
-----------------------------------------------
|
||||||
|
|
||||||
|
Below is a table mapping various :mod:`os` functions to their corresponding
|
||||||
|
:class:`PurePath`/:class:`Path` equivalent.
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
|
||||||
|
Although :func:`os.path.relpath` and :meth:`PurePath.relative_to` have some
|
||||||
|
overlapping use-cases, their semantics differ enough to warrant not
|
||||||
|
considering them equivalent.
|
||||||
|
|
||||||
|
============================ ==============================
|
||||||
|
os and os.path pathlib
|
||||||
|
============================ ==============================
|
||||||
|
:func:`os.path.abspath` :meth:`Path.resolve`
|
||||||
|
:func:`os.getcwd` :func:`Path.cwd`
|
||||||
|
:func:`os.path.exists` :meth:`Path.exists`
|
||||||
|
:func:`os.path.expanduser` :meth:`Path.expanduser` and
|
||||||
|
:meth:`Path.home`
|
||||||
|
:func:`os.path.isdir` :meth:`Path.is_dir`
|
||||||
|
:func:`os.path.isfile` :meth:`Path.is_file`
|
||||||
|
:func:`os.path.islink` :meth:`Path.is_symlink`
|
||||||
|
:func:`os.stat` :meth:`Path.stat`,
|
||||||
|
:meth:`Path.owner`,
|
||||||
|
: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.splitext` :data:`PurePath.suffix`
|
||||||
|
============================ ==============================
|
||||||
|
|
|
@ -33,6 +33,7 @@ Fred Allen
|
||||||
Jeff Allen
|
Jeff Allen
|
||||||
Ray Allen
|
Ray Allen
|
||||||
Billy G. Allie
|
Billy G. Allie
|
||||||
|
Jamiel Almeida
|
||||||
Kevin Altis
|
Kevin Altis
|
||||||
Skyler Leigh Amador
|
Skyler Leigh Amador
|
||||||
Joe Amenta
|
Joe Amenta
|
||||||
|
@ -436,6 +437,7 @@ Tim Everett
|
||||||
Paul Everitt
|
Paul Everitt
|
||||||
David Everly
|
David Everly
|
||||||
Daniel Evers
|
Daniel Evers
|
||||||
|
evilzero
|
||||||
Winston Ewert
|
Winston Ewert
|
||||||
Greg Ewing
|
Greg Ewing
|
||||||
Martijn Faassen
|
Martijn Faassen
|
||||||
|
@ -523,6 +525,7 @@ Elazar (אלעזר) Gershuni
|
||||||
Ben Gertzfield
|
Ben Gertzfield
|
||||||
Nadim Ghaznavi
|
Nadim Ghaznavi
|
||||||
Dinu Gherman
|
Dinu Gherman
|
||||||
|
Subhendu Ghosh
|
||||||
Jonathan Giddy
|
Jonathan Giddy
|
||||||
Johannes Gijsbers
|
Johannes Gijsbers
|
||||||
Michael Gilfix
|
Michael Gilfix
|
||||||
|
@ -1242,6 +1245,7 @@ Jérôme Radix
|
||||||
Burton Radons
|
Burton Radons
|
||||||
Abhilash Raj
|
Abhilash Raj
|
||||||
Shorya Raj
|
Shorya Raj
|
||||||
|
Dhushyanth Ramasamy
|
||||||
Jeff Ramnani
|
Jeff Ramnani
|
||||||
Bayard Randel
|
Bayard Randel
|
||||||
Varpu Rantala
|
Varpu Rantala
|
||||||
|
@ -1505,6 +1509,7 @@ Nathan Sullivan
|
||||||
Mark Summerfield
|
Mark Summerfield
|
||||||
Reuben Sumner
|
Reuben Sumner
|
||||||
Eryk Sun
|
Eryk Sun
|
||||||
|
Sanjay Sundaresan
|
||||||
Marek Šuppa
|
Marek Šuppa
|
||||||
Hisao Suzuki
|
Hisao Suzuki
|
||||||
Kalle Svensson
|
Kalle Svensson
|
||||||
|
@ -1747,7 +1752,3 @@ Jelle Zijlstra
|
||||||
Gennadiy Zlobin
|
Gennadiy Zlobin
|
||||||
Doug Zongker
|
Doug Zongker
|
||||||
Peter Åstrand
|
Peter Åstrand
|
||||||
evilzero
|
|
||||||
Dhushyanth Ramasamy
|
|
||||||
Subhendu Ghosh
|
|
||||||
Sanjay Sundaresan
|
|
||||||
|
|
Loading…
Reference in New Issue