"glob" --- 유닉스 스타일 경로명 패턴 확장
*****************************************

**소스 코드:** Lib/glob.py

======================================================================

"glob" 모듈은 유닉스 셸이 사용하는 규칙에 따라 지정된 패턴과 일치하는
모든 경로명을 찾습니다. 하지만 결과는 임의의 순서로 반환됩니다. 물결표
(tilde) 확장은 수행되지 않지만, "*", "?" 및 "[]"로 표시되는 문자 범위
는 올바르게 일치합니다. 이는 서브 셸을 실제로 호출하지 않고
"os.scandir()" 과 "fnmatch.fnmatch()" 함수를 사용하여 수행됩니다.
"fnmatch.fnmatch()"와 달리, "glob"은 점(".")으로 시작하는 파일 이름을
특수한 경우로 취급합니다. (물결표와 셸 변수 확장은
"os.path.expanduser()" 와 "os.path.expandvars()"를 사용하십시오.)

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

더 보기: "pathlib" 모듈은 고수준의 경로 객체를 제공합니다.

glob.glob(pathname, *, recursive=False)

   경로 지정을 포함하는 문자열인 *pathname*에 일치하는 경로 이름의 비
   어있을 수 있는 리스트를 반환합니다. *pathname*은 절대
   ("/usr/src/Python-1.5/Makefile"처럼)나 상대("../../Tools/*/*.gif"처
   럼)일 수 있으며, 셸 스타일 와일드카드를 포함할 수 있습니다. 깨진 심
   볼릭 링크가 결과에 포함됩니다 (셸과 마찬가지로). 결과가 정렬되는지
   는 파일 시스템에 따라 다릅니다. 이 함수 호출 중에 조건을 만족하는
   파일이 제거되거나 추가되면, 해당 파일의 경로 이름이 포함되는지는 지
   정되지 않습니다.

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

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

   참고:

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

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

glob.iglob(pathname, *, recursive=False)

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

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

glob.escape(pathname)

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

   버전 3.4에 추가.

예를 들어, 다음과 같은 파일을 포함하는 디렉터리를 고려하십시오:
"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"
     셸 스타일 파일명 (경로가 아님) 확장
