glob — Unix style pathname pattern expansion

소스 코드: Lib/glob.py

---

The glob module finds all the pathnames matching a specified pattern according to the rules used by the Unix shell, although results are returned in arbitrary order. 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.

Note that 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().)

리터럴 일치를 위해서는, 대괄호 안에 메타 문자를 넣습니다. 예를 들어, '[?]'는 '?' 문자와 일치합니다.

The glob module defines the following functions:

glob.glob(pathname, *, root_dir=None, dir_fd=None, recursive=False, 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 paths relative to directory descriptors with the dir_fd parameter.

recursive가 참이면, “**” 패턴은 모든 파일과 0개 이상의 디렉터리, 서브 디렉터리 및 디렉터리로의 심볼릭 링크와 일치합니다. 패턴 다음에 os.sep이나 os.altsep이 오면, 파일은 일치하지 않습니다.

If include_hidden is true, “**” pattern will match hidden directories.

pathname, recursive를 인자로 감사 이벤트(auditing event) glob.glob을 발생시킵니다.

Raises an auditing event glob.glob/2 with arguments pathname, recursive, root_dir, dir_fd.

참고

커다란 디렉터리 트리에서 “**” 패턴을 사용하면 과도한 시간이 걸릴 수 있습니다.

참고

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

버전 3.5에서 변경: “**” 를 사용하는 재귀적 glob 지원.

버전 3.10에서 변경: Added the root_dir and dir_fd parameters.

버전 3.11에서 변경: Added the include_hidden parameter.

glob.iglob(pathname, *, root_dir=None, dir_fd=None, recursive=False, include_hidden=False)

실제로 동시에 저장하지 않고 glob()과 같은 값을 산출하는 이터레이터를 반환합니다.

pathname, recursive를 인자로 감사 이벤트(auditing event) glob.glob을 발생시킵니다.

Raises an auditing event glob.glob/2 with arguments pathname, recursive, root_dir, dir_fd.

참고

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

버전 3.5에서 변경: “**” 를 사용하는 재귀적 glob 지원.

버전 3.10에서 변경: Added the root_dir and dir_fd parameters.

버전 3.11에서 변경: Added the include_hidden parameter.

glob.escape(pathname)

모든 특수 문자('?', '*' 및 '[')를 이스케이프 처리합니다. 이것은 특수 문자가 들어있을 수 있는 임의의 리터럴 문자열을 일치시키려는 경우에 유용합니다. 드라이브/UNC 셰어 포인트의 특수 문자는 이스케이프 되지 않습니다, 예를 들어, 윈도우에서 escape('//?/c:/Quo vadis?.txt')는 '//?/c:/Quo vadis[?].txt'를 반환합니다.

Added in version 3.4.

glob.translate(pathname, *, recursive=False, include_hidden=False, seps=None)

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 altsep (if available) are used.

더 보기

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

Added in version 3.13.

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/']

디렉터리에 .으로 시작하는 파일이 있으면, 기본적으로 일치하지 않습니다. 예를 들어, card.gif 와 .card.gif를 포함하는 디렉터리를 고려하십시오:

>>> import glob
>>> glob.glob('*.gif')
['card.gif']
>>> glob.glob('.c*')
['.card.gif']

더 보기

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

더 보기

pathlib 모듈은 고수준의 경로 객체를 제공합니다.