diff options
| author | Barney Gale <barney.gale@gmail.com> | 2024-03-22 19:14:09 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-03-22 19:14:09 (GMT) |
| commit | 72eea512b88f8fd68b7258242c37da963ad87360 (patch) | |
| tree | 5b904b2addf390594c8059e129fcb720c6558633 /Doc | |
| parent | e28477f214276db941e715eebc8cdfb96c1207d9 (diff) | |
| download | cpython-72eea512b88f8fd68b7258242c37da963ad87360.zip cpython-72eea512b88f8fd68b7258242c37da963ad87360.tar.gz cpython-72eea512b88f8fd68b7258242c37da963ad87360.tar.bz2 | |
GH-106747: Document another difference between `glob` and `pathlib`. (#116518)
Document that `path.glob()` might return *path*, whereas
`glob.glob(root_dir=path)` will never return an empty string corresponding
to *path*.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/library/pathlib.rst | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst index 3ff2631..4fba362 100644 --- a/Doc/library/pathlib.rst +++ b/Doc/library/pathlib.rst @@ -1682,6 +1682,10 @@ The patterns accepted and results generated by :meth:`Path.glob` and 5. The values returned from pathlib's ``path.glob()`` and ``path.rglob()`` include the *path* as a prefix, unlike the results of ``glob.glob(root_dir=path)``. +6. The values returned from pathlib's ``path.glob()`` and ``path.rglob()`` + may include *path* itself, for example when globbing "``**``", whereas the + results of ``glob.glob(root_dir=path)`` never include an empty string that + would correspond to *path*. Comparison to the :mod:`os` and :mod:`os.path` modules |