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

---

# [`fnmatch`](https://python-all.ru/3.10/library/fnmatch.html#module-fnmatch) – сопоставление с шаблонами имён файлов в стиле Unix

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

---

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

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

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

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

#### `fnmatch.fnmatch(filename, pattern)`

Проверяет, соответствует ли строка *filename* строке *pattern*, возвращая [`True`](https://python-all.ru/3.10/library/constants.html#True) или [`False`](https://python-all.ru/3.10/library/constants.html#False). Оба параметра нормализуются по регистру с помощью [`os.path.normcase()`](https://python-all.ru/3.10/library/os.path.html#os.path.normcase). [`fnmatchcase()`](https://python-all.ru/3.10/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(filename, pattern)`

Проверяет, соответствует ли *filename* *pattern*, возвращая [`True`](https://python-all.ru/3.10/library/constants.html#True) или [`False`](https://python-all.ru/3.10/library/constants.html#False); сравнение регистрозависимо и не применяет [`os.path.normcase()`](https://python-all.ru/3.10/library/os.path.html#os.path.normcase).

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

Создаёт список из тех элементов итерируемого объекта *names*, которые соответствуют *pattern*. Это то же самое, что `[n for n in names if fnmatch(n, pattern)]`, но реализовано более эффективно.

#### `fnmatch.translate(pattern)`

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

Пример:

```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.10/library/glob.html#module-glob)**
>
> Раскрытие путей в стиле оболочки Unix.