:mod:`!glob` --- Unix style pathname pattern expansion

فهرست فصل‌ها دانلود آرشیوناشر

Python 3.14 Docs · نسخهٔ 3.14.10 · PSF License

:mod:!glob --- Unix style pathname pattern expansion

:synopsis: Unix shell style pathname pattern expansion.

Source code: Lib/glob.py

--------------

single: * (asterisk); in glob-style wildcards single: ? (question mark); in glob-style wildcards single: [] (square brackets); in glob-style wildcards single: ! (exclamation); in glob-style wildcards single: - (minus); in glob-style wildcards single: . (dot); in glob-style wildcards

The !glob module finds pathnames using pattern matching rules similar to the Unix shell. No tilde expansion is done, but `*, ?, and character ranges expressed with [] will be correctly matched. This is done by using the os.scandir and fnmatch.fnmatch` functions in concert, and not by actually invoking a subshell.

The pathnames are returned in no particular order. If you need a specific order, sort the results.

By default, files beginning with a dot (`.) can only be matched by patterns that also start with a dot, unlike fnmatch.fnmatch or pathlib.Path.glob. For tilde and shell variable expansion, use os.path.expanduser and os.path.expandvars`.

For a literal match, wrap the meta-characters in brackets. For example, `'[?]' matches the character '?'`.

The !glob module defines the following functions:

include_hidden=False)

Return a possibly empty list of path names that match *pathname*, which must be a string containing a path specification. *pathname* can be either absolute (like /usr/src/Python-1.5/Makefile) or relative (like ../../Tools/\*/\*.gif), and can contain shell-style wildcards. Broken symlinks are included in the results (as in the shell). Whether or not the results are sorted depends on the file system. If a file that satisfies conditions is removed or added during the call of this function, whether a path name for that file will be included is unspecified.

If *root_dir* is not `None, it should be a path-like object specifying the root directory for searching. It has the same effect on !glob` as changing the current directory before calling it. If *pathname* is relative, the result will contain paths relative to *root_dir*.

This function can support :ref:paths relative to directory descriptors <dir_fd> with the *dir_fd* parameter.

single: **; in glob-style wildcards

If *recursive* is true, the pattern "`**" will match any files and zero or more directories, subdirectories and symbolic links to directories. If the pattern is followed by an os.sep or os.altsep` then files will not match.

If *include_hidden* is true, wildcards can match path segments that begin with a dot (`.`).

Using the "`**`" pattern in large directory trees may consume an inordinate amount of time.

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

Any OSError exceptions raised from scanning the filesystem are suppressed. This includes PermissionError when accessing directories without read permission.

Support for recursive globs using "`**`".

Added the *root_dir* and *dir_fd* parameters.

Added the *include_hidden* parameter.

include_hidden=False)

Return an iterator which yields the same values as glob without actually storing them all simultaneously.

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

Any OSError exceptions raised from scanning the filesystem are suppressed. This includes PermissionError when accessing directories without read permission.

Support for recursive globs using "`**`".

Added the *root_dir* and *dir_fd* parameters.

Added the *include_hidden* parameter.

Escape all special characters (`'?', '*' and '['). This is useful if you want to match an arbitrary literal string that may have special characters in it. Special characters in drive/UNC sharepoints are not escaped, for example on Windows escape('//?/c:/Quo vadis?.txt') returns '//?/c:/Quo vadis[?].txt'`.

Convert the given path specification to a regular expression for use with re.match. The path specification can contain shell-style wildcards.

For example:

توجه: >> import glob, re >> >> regex = glob.translate('**/*.txt', recursive=True, include_hidden=True) >> regex

'(?s:(?:.+/)?[^/]*\\.txt)\\z'

توجه: >> reobj = re.compile(regex) >> reobj.match('foo/bar/baz.txt')

<re.Match object; span=(0, 15), match='foo/bar/baz.txt'>

Path separators and segments are meaningful to this function, unlike fnmatch.translate. By default wildcards do not match path separators, and `*` pattern segments match precisely one path segment.

If *recursive* is true, the pattern segment "`**`" will match any number of path segments.

If *include_hidden* is true, wildcards can match path segments that start with a dot (`.`).

A sequence of path separators may be supplied to the *seps* argument. If not given, os.sep and ~os.altsep (if available) are used.

pathlib.PurePath.full_match and pathlib.Path.glob methods, which call this function to implement pattern matching and globbing.

Examples

Consider a directory containing the following files: 1.gif, 2.txt, card.gif and a subdirectory sub which contains only the file 3.txt. glob will produce the following results. Notice how any leading components of the path are preserved. ::

توجه: >> import glob >> glob.glob('./[0-9].*')

['./1.gif', './2.txt']

توجه: >> glob.glob('*.gif')

['1.gif', 'card.gif']

توجه: >> glob.glob('?.gif')

['1.gif']

توجه: >> glob.glob('**/*.txt', recursive=True)

['2.txt', 'sub/3.txt']

توجه: >> glob.glob('./**/', recursive=True)

['./', './sub/']

If the directory contains files starting with `. they won't be matched by default. For example, consider a directory containing card.gif and .card.gif`::

توجه: >> import glob >> glob.glob('*.gif')

['card.gif']

توجه: >> glob.glob('.c*')

['.card.gif']

The fnmatch module offers shell-style filename (not path) expansion.

The pathlib module offers high-level path objects.