Skip to content

gh-84548: Document Windows specific behavior of abspath() and realpath() #155388

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
serhiy-storchaka wants to merge 1 commit into
base: main
Choose a base branch
from
+15 −0
Open

gh-84548: Document Windows specific behavior of abspath() and realpath() #155388

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions Doc/library/os.path.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,18 @@ the :mod:`glob` module.)
Return a normalized absolutized version of the pathname *path*. On most
platforms, this is equivalent to calling ``normpath(join(os.getcwd(), path))``.

On Windows the path is normalized by the operating system,
therefore the result can differ from ``normpath(join(os.getcwd(), path))``.
A drive-relative path is resolved against the current directory
of the specified drive, and the drive letter is capitalized.
Trailing dots and spaces are stripped.
For example::

>>> os.path.abspath('c:spam')
'C:\\Temp\\spam'
>>> os.path.abspath('c:/temp/spam. . .')
'c:\\temp\\spam'

.. seealso:: :func:`os.path.join` and :func:`os.path.normpath`.

.. versionchanged:: 3.6
Expand Down Expand Up @@ -435,6 +447,9 @@ the :mod:`glob` module.)
links encountered in the path (if they are supported by the operating
system). On Windows, this function will also resolve MS-DOS (also called 8.3)
style names such as ``C:\\PROGRA~1`` to ``C:\\Program Files``.
The returned path uses the case reported by the operating system,
which can differ from the case of *path*,
in particular the drive letter is capitalized.

By default, the path is evaluated up to the first component that does not
exist, is a symlink loop, or whose evaluation raises :exc:`OSError`.
Expand Down
Loading