Skip to content

GH-77609: Add follow_symlinks argument to pathlib.Path.glob() #102616

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

Merged
barneygale merged 17 commits into from
May 29, 2023
Merged

GH-77609: Add follow_symlinks argument to pathlib.Path.glob() #102616

Changes from 1 commit
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
59dcdb1
GH-77609: Support following symlinks in `pathlib.Path.glob()`
barneygale Mar 12, 2023
e850bde
Fix top-level error handling.
barneygale Mar 12, 2023
4f4ffd3
Always follow top-level symlink
barneygale Mar 12, 2023
b6c019e
Simplify test diff slightly
barneygale Mar 12, 2023
8d657ee
Clarify docs for *follow_symlinks* argument
barneygale Mar 14, 2023
b600363
Backwards compatibility
barneygale Mar 14, 2023
b2766f8
Fix handling of '..' in patterns.
barneygale Mar 14, 2023
8704d33
Deprecate follow_symlinks=None
barneygale Mar 14, 2023
6f7a83a
Fix news
barneygale Mar 14, 2023
5fb7d28
Merge branch 'main' into gh-77609-glob-follow-symlinks
barneygale May 3, 2023
ce7973f
Revert "Fix news"
barneygale May 10, 2023
2db28d9
Revert "Deprecate follow_symlinks=None"
barneygale May 10, 2023
d3a3396
Merge branch 'main' into gh-77609-glob-follow-symlinks
barneygale May 10, 2023
6c61822
Merge branch 'main' into gh-77609-glob-follow-symlinks
barneygale May 11, 2023
3722b64
Merge branch 'main' into gh-77609-glob-follow-symlinks
barneygale May 15, 2023
9700dd1
Merge branch 'main' into gh-77609-glob-follow-symlinks
barneygale May 23, 2023
4f2a492
Re-target to 3.13
barneygale May 23, 2023
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
Prev Previous commit
Next Next commit
Clarify docs for *follow_symlinks* argument
  • Loading branch information
@barneygale
barneygale committed Mar 14, 2023
commit 8d657eeaf421e3defee08fe5ff585bbd11a7cf65
14 changes: 8 additions & 6 deletions Doc/library/pathlib.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -873,8 +873,8 @@ call fails (for example because the path doesn't exist).
PosixPath('setup.py'),
PosixPath('test_pathlib.py')]

By default, :meth:`Path.glob` does not follow symlinks. Set
*follow_symlinks* to true to visit symlinks to directories.
By default, :meth:`Path.glob` does not follow symlinks when expanding a
pattern. Set *follow_symlinks* to true to visit symlinks to directories.

.. note::
Using the "``**``" pattern in large directory trees may consume
Expand All @@ -888,7 +888,8 @@ call fails (for example because the path doesn't exist).

.. versionchanged:: 3.12
The *follow_symlinks* parameter was added. In previous versions,
symlinks were followed except when expanding "``**``" wildcards.
symlinks were followed when expanding patterns, except when expanding
"``**``" wildcards.

.. method:: Path.group()

Expand Down Expand Up @@ -1288,8 +1289,8 @@ call fails (for example because the path doesn't exist).
PosixPath('setup.py'),
PosixPath('test_pathlib.py')]

By default, :meth:`Path.rglob` does not follow symlinks. Set
*follow_symlinks* to true to visit symlinks to directories.
By default, :meth:`Path.rglob` does not follow symlinks when expanding a
pattern. Set *follow_symlinks* to true to visit symlinks to directories.

.. audit-event:: pathlib.Path.rglob self,pattern pathlib.Path.rglob

Expand All @@ -1299,7 +1300,8 @@ call fails (for example because the path doesn't exist).

.. versionchanged:: 3.12
The *follow_symlinks* parameter was added. In previous versions,
symlinks were followed except when expanding "``**``" wildcards.
symlinks were followed when expanding patterns, except when expanding
"``**``" wildcards.

.. method:: Path.rmdir()

Expand Down