> **Источник:** https://python-all.ru/3.12/library/fnmatch.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# `fnmatch` – сопоставление с шаблонами имён файлов в стиле Unix

**Исходный код:** [Lib/fnmatch.py](https://python-all.ru/src/3.12/Lib/fnmatch.py)

---

Этот модуль обеспечивает поддержку шаблонов с подстановочными символами в стиле оболочки Unix, которые *не* совпадают с регулярными выражениями (документированными в модуле [`re`](https://python-all.ru/3.12/library/re.html#module-re)). Специальные символы, используемые в шаблонах оболочки:

| Шаблон | Значение |
| --- | --- |
| `*` | соответствует всему |
| `?` | соответствует одному любому символу |
| `[seq]` | соответствует любому символу из *seq* |
| `[!seq]` | соответствует любому символу не из *seq* |

Для точного совпадения заключите метасимволы в скобки. Например, `'[?]'` соответствует символу `'?'`.

Обратите внимание, что разделитель имён файлов (`'/'` в Unix) *не* является специальным для этого модуля. Смотрите модуль [`glob`](https://python-all.ru/3.12/library/glob.html#module-glob) для раскрытия путей ([`glob`](https://python-all.ru/3.12/library/glob.html#module-glob) использует [`filter()`](https://python-all.ru/3.12/library/fnmatch.html#fnmatch.filter) для сопоставления сегментов путей). Аналогично, имена файлов, начинающиеся с точки, не являются специальными для этого модуля и сопоставляются с помощью шаблонов `*` и `?`.

Если не указано иное, «строка имени файла» и «строка шаблона» относятся к объектам [`str`](https://python-all.ru/3.12/library/stdtypes.html#str) или `ISO-8859-1`, закодированным в [`bytes`](https://python-all.ru/3.12/library/stdtypes.html#bytes). Обратите внимание, что документированные ниже функции не позволяют смешивать шаблон `bytes` с именем файла `str`, и наоборот.

Наконец, отметьте, что [`functools.lru_cache()`](https://python-all.ru/3.12/library/functools.html#functools.lru_cache) с *maxsize*, равным 32768, используется для кэширования (типизированных) скомпилированных регулярных выражений в следующих функциях: [`fnmatch()`](https://python-all.ru/3.12/library/fnmatch.html#module-fnmatch), [`fnmatchcase()`](https://python-all.ru/3.12/library/fnmatch.html#fnmatch.fnmatchcase), [`filter()`](https://python-all.ru/3.12/library/fnmatch.html#fnmatch.filter).

#### `fnmatch.fnmatch(name, pat)`

Проверяет, соответствует ли строка имени файла *name* строке шаблона *pat*, возвращая `True` или `False`. Оба параметра нормализуются по регистру с помощью [`os.path.normcase()`](https://python-all.ru/3.12/library/os.path.html#os.path.normcase). [`fnmatchcase()`](https://python-all.ru/3.12/library/fnmatch.html#fnmatch.fnmatchcase) можно использовать для выполнения регистрозависимого сравнения, независимо от того, является ли это стандартным для операционной системы.

Этот пример выведет все имена файлов в текущем каталоге с расширением `.txt`:

```python
import fnmatch
import os

for file in os.listdir('.'):
    if fnmatch.fnmatch(file, '*.txt'):
        print(file)
```

#### `fnmatch.fnmatchcase(name, pat)`

Проверяет, соответствует ли строка имени файла *name* строке шаблона *pat*, возвращая `True` или `False`; сравнение регистрозависимо и не применяет [`os.path.normcase()`](https://python-all.ru/3.12/library/os.path.html#os.path.normcase).

#### `fnmatch.filter(names, pat)`

Строит список из тех элементов [iterable](https://python-all.ru/3.12/glossary.html#term-iterable) строк имён файлов *names*, которые соответствуют строке шаблона *pat*. Это то же самое, что `[n for n in names if fnmatch(n, pat)]`, но реализовано более эффективно.

#### `fnmatch.translate(pat)`

Возвращает шаблон в стиле оболочки *pat*, преобразованный в регулярное выражение для использования с [`re.match()`](https://python-all.ru/3.12/library/re.html#re.match). Ожидается, что шаблон будет [`str`](https://python-all.ru/3.12/library/stdtypes.html#str).

Пример:

```python
>>> import fnmatch, re
>>>
>>> regex = fnmatch.translate('*.txt')
>>> regex
'(?s:.*\\.txt)\\Z'
>>> reobj = re.compile(regex)
>>> reobj.match('foobar.txt')
<re.Match object; span=(0, 10), match='foobar.txt'>
```

> **См. также**
>
> **Модуль [`glob`](https://python-all.ru/3.12/library/glob.html#module-glob)**
>
> Раскрытие путей в стиле оболочки Unix.