[Python-checkins] gh-87691: add an absolute path pathlib example in / operator docs (GH-100737)
miss-islington
webhook-mailer at python.org
Thu Jan 5 18:05:03 EST 2023
https://github.com/python/cpython/commit/4bdc57a3d2aceadbc9150febe6717ef92b8d6aa5
commit: 4bdc57a3d2aceadbc9150febe6717ef92b8d6aa5
branch: 3.10
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2023-01-05T15:04:57-08:00
summary:
gh-87691: add an absolute path pathlib example in / operator docs (GH-100737)
The behaviour is fully explained a couple paragraphs above, but it may be useful to have a brief example to cover the behaviour.
(cherry picked from commit 1ae619c911ec8e096f83eeb7cc57fcd966950a3d)
Co-authored-by: Shantanu <12621235+hauntsaninja at users.noreply.github.com>
Automerge-Triggered-By: GH:hauntsaninja
files:
M Doc/library/pathlib.rst
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index f969b1104f08..316fee2a0401 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -212,7 +212,10 @@ Paths of a different flavour compare unequal and cannot be ordered::
Operators
^^^^^^^^^
-The slash operator helps create child paths, similarly to :func:`os.path.join`::
+The slash operator helps create child paths, mimicking the behaviour of
+:func:`os.path.join`. For instance, when several absolute paths are given, the
+last is taken as an anchor; for a Windows path, changing the local root doesn't
+discard the previous drive setting::
>>> p = PurePath('/etc')
>>> p
@@ -222,6 +225,10 @@ The slash operator helps create child paths, similarly to :func:`os.path.join`::
>>> q = PurePath('bin')
>>> '/usr' / q
PurePosixPath('/usr/bin')
+ >>> p / '/an_absolute_path'
+ PurePosixPath('/an_absolute_path')
+ >>> PureWindowsPath('c:/Windows', '/Program Files')
+ PureWindowsPath('c:/Program Files')
A path object can be used anywhere an object implementing :class:`os.PathLike`
is accepted::
More information about the Python-checkins
mailing list