Skip to content

gh-104269: Document glob.glob duplicates when using multiple ** patterns #105406

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
merged 11 commits into from
Apr 11, 2024
Merged

gh-104269: Document glob.glob duplicates when using multiple ** patterns #105406

Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
d034bc7
Mention that glob.glob can sometimes return duplicates
tomasr8 Jun 6, 2023
98ce46b
Add news entry
tomasr8 Jun 6, 2023
a8aba33
Merge branch 'main' into glob-duplicates
tomasr8 Jun 12, 2023
369c9d3
Merge branch 'main' into glob-duplicates
tomasr8 Jul 19, 2023
6175bc0
Fix changelog
tomasr8 Jul 23, 2023
ef02c06
Use 'could' rather than 'might'
tomasr8 Jul 24, 2023
fe34443
Improve wording
tomasr8 Jan 22, 2024
75d8eaf
Remove news entry
tomasr8 Jan 22, 2024
3020e80
Merge branch 'main' into glob-duplicates
tomasr8 Jan 22, 2024
7d74b0b
Merge branch 'main' into glob-duplicates
tomasr8 Mar 19, 2024
5b7a49f
Merge branch 'main' into glob-duplicates
barneygale Apr 11, 2024
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
8 changes: 8 additions & 0 deletions Doc/library/glob.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,10 @@ The :mod:`glob` module defines the following functions:
Using the "``**``" pattern in large directory trees may consume
an inordinate amount of time.

.. note::
This function may return duplicate path names if *pathname*
contains multiple "``**``" patterns and *recursive* is true.

.. versionchanged:: 3.5
Support for recursive globs using "``**``".

Expand All @@ -94,6 +98,10 @@ The :mod:`glob` module defines the following functions:
.. audit-event:: glob.glob pathname,recursive glob.iglob
.. audit-event:: glob.glob/2 pathname,recursive,root_dir,dir_fd glob.iglob

.. note::
This function may return duplicate path names if *pathname*
contains multiple "``**``" patterns and *recursive* is true.

.. versionchanged:: 3.5
Support for recursive globs using "``**``".

Expand Down