https://github.com/python/cpython/commit/a199ab3f333a2e0bab37db935030f835c0740d08
commit: a199ab3f333a2e0bab37db935030f835c0740d08
branch: 3.12
author: Miss Islington (bot) <[email protected]>
committer: barneygale <[email protected]>
date: 2024-01-23T01:12:59Z
summary:
[3.12] GH-99334: Explain that `PurePath.is_relative_to()` is purely lexical.
(GH-114031) (#114460)
(cherry picked from commit 3a61d24062aaa1e13ba794360b6c765d9a1f2b06)
files:
M Doc/library/pathlib.rst
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 46a4d10b11d602..701131b5b2ec46 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -509,6 +509,13 @@ Pure paths provide the following methods and properties:
>>> p.is_relative_to('/usr')
False
+ This method is string-based; it neither accesses the filesystem nor treats
+ "``..``" segments specially. The following code is equivalent:
+
+ >>> u = PurePath('/usr')
+ >>> u == p or u in p.parents
+ False
+
.. versionadded:: 3.9
.. deprecated-removed:: 3.12 3.14
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: [email protected]
