`glob.md`

78 строк · 7.1 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.8/library/glob.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# [`glob`](https://python-all.ru/3.8/library/glob.html#module-glob) – расширение шаблонов путей в стиле Unix89**Исходный код:** [Lib/glob.py](https://python-all.ru/src/3.8/Lib/glob.py)1011---1213Модуль [`glob`](https://python-all.ru/3.8/library/glob.html#module-glob) находит все пути, соответствующие заданному шаблону, по правилам, используемым в оболочке Unix, хотя результаты возвращаются в произвольном порядке. Подстановка тильды не выполняется, но `*`, `?` и диапазоны символов, заданные с помощью `[]`, будут правильно сопоставлены. Это делается с помощью функций [`os.scandir()`](https://python-all.ru/3.8/library/os.html#os.scandir) и [`fnmatch.fnmatch()`](https://python-all.ru/3.8/library/fnmatch.html#fnmatch.fnmatch), без фактического вызова подоболочки. Обратите внимание, что, в отличие от [`fnmatch.fnmatch()`](https://python-all.ru/3.8/library/fnmatch.html#fnmatch.fnmatch), [`glob`](https://python-all.ru/3.8/library/glob.html#module-glob) обрабатывает имена файлов, начинающиеся с точки (`.`), как особый случай. (Для подстановки тильды и переменных оболочки используйте [`os.path.expanduser()`](https://python-all.ru/3.8/library/os.path.html#os.path.expanduser) и [`os.path.expandvars()`](https://python-all.ru/3.8/library/os.path.html#os.path.expandvars).)1415Для точного совпадения заключите метасимволы в скобки. Например, `'[?]'` соответствует символу `'?'`.1617> **См. также**18>19> Модуль [`pathlib`](https://python-all.ru/3.8/library/pathlib.html#module-pathlib) предоставляет высокоуровневые объекты путей.2021#### `glob.glob(pathname, *, recursive=False)`2223Возвращает список имён путей (возможно пустой), соответствующих *pathname*, который должен быть строкой, содержащей спецификацию пути. *pathname* может быть абсолютным (например, `/usr/src/Python-1.5/Makefile`) или относительным (например, `../../Tools/*/*.gif`) и может содержать подстановочные символы в стиле оболочки. Сломанные символические ссылки включаются в результаты (как в оболочке). Отсортированы результаты или нет, зависит от файловой системы. Если файл, удовлетворяющий условиям, был удалён или добавлен во время вызова этой функции, не определено, будет ли включено имя пути для этого файла.2425Если *recursive* истинно, шаблон «`**`» будет соответствовать любым файлам и нулю или более каталогам, подкаталогам и символическим ссылкам на каталоги. Если за шаблоном следует [`os.sep`](https://python-all.ru/3.8/library/os.html#os.sep) или [`os.altsep`](https://python-all.ru/3.8/library/os.html#os.altsep), файлы не будут сопоставляться.2627Возбуждает [событие аудита](https://python-all.ru/3.8/library/sys.html#auditing) `glob.glob` с аргументами `pathname`, `recursive`.2829> **Примечание**30>31> Использование шаблона «`**`» в больших деревьях каталогов может занять чрезмерно много времени.3233Изменено в версии 3.5: Добавлена поддержка рекурсивных шаблонов с помощью «`**`».3435#### `glob.iglob(pathname, *, recursive=False)`3637Возвращает [итератор](https://python-all.ru/3.8/glossary.html#term-iterator), который порождает те же значения, что и [`glob()`](https://python-all.ru/3.8/library/glob.html#module-glob), но не сохраняет их все одновременно.3839Возбуждает [событие аудита](https://python-all.ru/3.8/library/sys.html#auditing) `glob.glob` с аргументами `pathname`, `recursive`.4041#### `glob.escape(pathname)`4243Экранирует все специальные символы (`'?'`, `'*'` и `'['`). Это полезно, если нужно сопоставить произвольную буквальную строку, которая может содержать специальные символы. Специальные символы в точках монтирования дисков/UNC не экранируются, например, в Windows `escape('//?/c:/Quo vadis?.txt')` возвращает `'//?/c:/Quo vadis[?].txt'`.4445Новое в версии 3.4.4647Например, рассмотрим каталог, содержащий следующие файлы: `1.gif`, `2.txt`, `card.gif` и подкаталог `sub`, который содержит только файл `3.txt`. [`glob()`](https://python-all.ru/3.8/library/glob.html#module-glob) выдаст следующие результаты. Обратите внимание, что все начальные компоненты пути сохраняются.4849```python50>>> import glob51>>> glob.glob('./[0-9].*')52['./1.gif', './2.txt']53>>> glob.glob('*.gif')54['1.gif', 'card.gif']55>>> glob.glob('?.gif')56['1.gif']57>>> glob.glob('**/*.txt', recursive=True)58['2.txt', 'sub/3.txt']59>>> glob.glob('./**/', recursive=True)60['./', './sub/']61```6263Если каталог содержит файлы, начинающиеся с `.`, они не будут сопоставлены по умолчанию. Например, рассмотрим каталог, содержащий `card.gif` и `.card.gif`:6465```python66>>> import glob67>>> glob.glob('*.gif')68['card.gif']69>>> glob.glob('.c*')70['.card.gif']71```7273> **См. также**74>75> **Модуль [`fnmatch`](https://python-all.ru/3.8/library/fnmatch.html#module-fnmatch)**76>77> Расширение имен файлов (не путей) в стиле оболочки78