glob — 유닉스 스타일 경로명 패턴 확장¶
소스 코드: Lib/glob.py
glob 모듈은 Unix 셸과 유사한 패턴 매칭 규칙을 사용하여 경로명을 찾습니다. 물결표(~) 확장은 수행되지 않지만, *, ? 및 [] 로 표현되는 문자 범위는 올바르게 매치됩니다. 이는 실제로 서브셸을 호출하는 대신 os.scandir() 및 fnmatch.fnmatch() 함수를 함께 사용하여 수행됩니다.
참고
경로명은 특별한 순서 없이 반환됩니다. 특정 순서가 필요한 경우 결과를 정렬하십시오.
fnmatch.fnmatch() 또는 pathlib.Path.glob() 과 달리 점(.)으로 시작하는 파일은 마찬가지로 점으로 시작하는 패턴으로만 매치될 수 있습니다. 물결표 및 셸 변수 확장을 위해서는 os.path.expanduser() 및 os.path.expandvars() 를 사용하십시오.
리터럴 일치를 위해서는, 대괄호 안에 메타 문자를 넣습니다. 예를 들어, '[?]'는 '?' 문자와 일치합니다.
glob 모듈은 다음 함수들을 정의합니다:
- glob.glob(pathname, *, root_dir=None, dir_fd=None, recursive=False, include_hidden=False)¶
경로 지정을 포함하는 문자열인 pathname에 일치하는 경로 이름의 비어있을 수 있는 리스트를 반환합니다. pathname은 절대(
/usr/src/Python-1.5/Makefile처럼)나 상대(../../Tools/*/*.gif처럼)일 수 있으며, 셸 스타일 와일드카드를 포함할 수 있습니다. 깨진 심볼릭 링크가 결과에 포함됩니다 (셸과 마찬가지로). 결과가 정렬되는지는 파일 시스템에 따라 다릅니다. 이 함수 호출 중에 조건을 만족하는 파일이 제거되거나 추가되면, 해당 파일의 경로 이름이 포함될지는 지정되지 않습니다.root_dir 이
None이 아닌 경우, 이는 검색 루트 디렉터리를 지정하는 path-like object 여야 합니다. 이 인자는glob()을 호출하기 전에 현재 디렉터리를 변경하는 것과 동일한 효과를 가집니다. pathname 이 상대 경로인 경우, 결과에는 root_dir 에 대한 상대 경로가 포함됩니다.이 함수는 dir_fd 매개변수를 통해 디렉터리 기술자에 상대적인 경로 를 지원할 수 있습니다.
recursive가 참이면, “
**” 패턴은 모든 파일과 0개 이상의 디렉터리, 서브 디렉터리 및 디렉터리로의 심볼릭 링크와 일치합니다. 패턴 다음에os.sep이나os.altsep이 오면, 파일은 일치하지 않습니다.include_hidden 이 참인 경우, “
**“ 패턴이 숨겨진 디렉터리를 매치합니다.pathname,recursive를 인자로 감사 이벤트(auditing event)glob.glob을 발생시킵니다.pathname,recursive,root_dir,dir_fd를 인자로 감사 이벤트(auditing event)glob.glob/2을 발생시킵니다.참고
커다란 디렉터리 트리에서 “
**” 패턴을 사용하면 과도한 시간이 걸릴 수 있습니다.참고
pathname 에 여러 개의 “
**“ 패턴이 포함되어 있고 recursive 가 True인 경우, 이 함수는 중복된 경로명을 반환할 수 있습니다.참고
파일 시스템을 스캔하는 중에 발생하는 모든
OSError예외는 무시됩니다. 여기에는 읽기 권한이 없는 디렉터리에 접근할 때 발생하는PermissionError도 포함됩니다.버전 3.5에서 변경: “
**” 를 사용하는 재귀적 glob 지원.버전 3.10에서 변경: root_dir 과 dir_fd 매개 변수를 추가했습니다.
버전 3.11에서 변경: include_hidden 매개 변수를 추가했습니다.
- glob.iglob(pathname, *, root_dir=None, dir_fd=None, recursive=False, include_hidden=False)¶
실제로 동시에 저장하지 않고
glob()과 같은 값을 산출하는 이터레이터를 반환합니다.pathname,recursive를 인자로 감사 이벤트(auditing event)glob.glob을 발생시킵니다.pathname,recursive,root_dir,dir_fd를 인자로 감사 이벤트(auditing event)glob.glob/2을 발생시킵니다.참고
pathname 에 여러 개의 “
**“ 패턴이 포함되어 있고 recursive 가 True인 경우, 이 함수는 중복된 경로명을 반환할 수 있습니다.참고
파일 시스템을 스캔하는 중에 발생하는 모든
OSError예외는 무시됩니다. 여기에는 읽기 권한이 없는 디렉터리에 접근할 때 발생하는PermissionError도 포함됩니다.버전 3.5에서 변경: “
**” 를 사용하는 재귀적 glob 지원.버전 3.10에서 변경: root_dir 과 dir_fd 매개 변수를 추가했습니다.
버전 3.11에서 변경: include_hidden 매개 변수를 추가했습니다.
- 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)¶
주어진 경로 사양을
re.prefixmatch()에서 사용할 수 있는 정규 표현식으로 변환합니다. 경로 사양은 셸 스타일 와일드카드를 포함할 수 있습니다.예를 들어:
>>> import glob, re >>> >>> regex = glob.translate('**/*.txt', recursive=True, include_hidden=True) >>> regex '(?s:(?:.+/)?[^/]*\\.txt)\\z' >>> reobj = re.compile(regex) >>> reobj.prefixmatch('foo/bar/baz.txt') <re.Match object; span=(0, 15), match='foo/bar/baz.txt'>
fnmatch.translate`와 달리 이 함수는 경로 구분자와 세그먼트를 구분합니다. 기본적으로 와일드카드는 경로 구분자와 매치되지 않으며, ``*`()패턴 세그먼트는 정확히 하나의 경로 세그먼트만 매치합니다.recursive 가 참이면, “
**“ 패턴은 임의의 개수의 경로 세그먼트와 매치됩니다.include_hidden 이 참이면, 와일드카드가 점(
.)으로 시작하는 경로 세그먼트와 매치될 수 있습니다.seps 인자에 경로 구분자 시퀀스를 제공할 수 있습니다. 제공되지 않으면
os.sep와altsep(사용 가능한 경우)이 사용됩니다.더 보기
패턴 매칭과 글로빙을 구현하기 위해 이 함수를 호출하는
pathlib.PurePath.full_match()및pathlib.Path.glob()메서드입니다.Added in version 3.13.
예제¶
다음과 같은 파일을 포함하는 디렉터리를 고려하십시오: 1.gif, 2.txt, card.gif 및 3.txt 파일 만 포함하는 서브 디렉터리 sub. glob()은 다음과 같은 결과를 산출합니다. 경로의 선행 구성 요소가 보존되는 방법에 유의하십시오.
>>> 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']
더 보기
fnmatch 모듈은 셸 스타일 파일명 (경로가 아님) 확장을 제공합니다.
더 보기
pathlib 모듈은 고수준의 경로 객체를 제공합니다.