https://github.com/python/cpython/commit/9d13ca97c1a83ed649a16fb0512b5f1c5f9ad108
commit: 9d13ca97c1a83ed649a16fb0512b5f1c5f9ad108
branch: main
author: Bartosz Sławecki <[email protected]>
committer: ZeroIntensity <[email protected]>
date: 2026-01-11T14:36:47-05:00
summary:
gh-142972: Document arbitrary ordering in `Path.glob` and `Path.rglob`
(GH-143025)
files:
M Doc/library/pathlib.rst
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
index 79e0b7f09eaa77..1575de6c6f5935 100644
--- a/Doc/library/pathlib.rst
+++ b/Doc/library/pathlib.rst
@@ -1331,6 +1331,10 @@ Reading directories
PosixPath('setup.py'),
PosixPath('test_pathlib.py')]
+ .. note::
+ The paths are returned in no particular order.
+ If you need a specific order, sort the results.
+
.. seealso::
:ref:`pathlib-pattern-language` documentation.
@@ -1365,6 +1369,10 @@ Reading directories
Glob the given relative *pattern* recursively. This is like calling
:func:`Path.glob` with "``**/``" added in front of the *pattern*.
+ .. note::
+ The paths are returned in no particular order.
+ If you need a specific order, sort the results.
+
.. seealso::
:ref:`pathlib-pattern-language` and :meth:`Path.glob` documentation.
_______________________________________________
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]
