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

---

# `modulefinder` – Поиск модулей, используемых сценарием

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

---

Этот модуль предоставляет класс [`ModuleFinder`](https://python-all.ru/3.16/library/modulefinder.html#modulefinder.ModuleFinder), который можно использовать для определения набора модулей, импортированных сценарием. `modulefinder.py` также можно запускать как сценарий, передав имя файла Python-сценария в качестве аргумента, после чего будет выведен отчёт об импортированных модулях.

#### `modulefinder.AddPackagePath(pkg_name, path)`

Записывает, что пакет с именем *pkg\_name* можно найти по указанному *пути*.

#### `modulefinder.ReplacePackage(oldname, newname)`

Позволяет указать, что модуль с именем *oldname* на самом деле является пакетом с именем *newname*.

#### `class modulefinder.ModuleFinder(path=None, debug=0, excludes=[], replace_paths=[])`

Этот класс предоставляет методы [`run_script()`](https://python-all.ru/3.16/library/modulefinder.html#modulefinder.ModuleFinder.run_script) и [`report()`](https://python-all.ru/3.16/library/modulefinder.html#modulefinder.ModuleFinder.report) для определения набора модулей, импортированных сценарием. *path* может быть списком каталогов для поиска модулей; если не указан, используется `sys.path`. *debug* задаёт уровень отладки; более высокие значения заставляют класс выводить отладочные сообщения о том, что он делает. *excludes* – это список имён модулей, исключаемых из анализа. *replace\_paths* – это список кортежей `(oldpath, newpath)`, которые будут заменены в путях модулей.

#### `report()`

Выводит в стандартный вывод отчёт со списком модулей, импортированных сценарием, и их путей, а также модулей, которые отсутствуют или, возможно, отсутствуют.

#### `run_script(pathname)`

Анализирует содержимое файла *pathname*, который должен содержать код Python.

#### `modules`

Словарь, сопоставляющий имена модулей с модулями. См. [Пример использования ModuleFinder](https://python-all.ru/3.16/library/modulefinder.html#modulefinder-example).

## Пример использования [`ModuleFinder`](https://python-all.ru/3.16/library/modulefinder.html#modulefinder.ModuleFinder)

Сценарий, который будет проанализирован позже (bacon.py):

```python
import re, itertools

try:
    import baconhameggs
except ImportError:
    pass

try:
    import guido.python.ham
except ImportError:
    pass
```

Сценарий, который выведет отчёт для bacon.py:

```python
from modulefinder import ModuleFinder

finder = ModuleFinder()
finder.run_script('bacon.py')

print('Loaded modules:')
for name, mod in finder.modules.items():
    print('%s: ' % name, end='')
    print(','.join(list(mod.globalnames.keys())[:3]))

print('-'*50)
print('Modules not imported:')
print('\n'.join(finder.badmodules.keys()))
```

Пример вывода (может отличаться в зависимости от архитектуры):

```python
Loaded modules:
_types:
copyreg:  _inverted_registry,_slotnames,__all__
re._compiler:  isstring,_sre,_optimize_unicode
_sre:
re._constants:  REPEAT_ONE,makedict,AT_END_LINE
sys:
re:  __module__,finditer,_expand
itertools:
__main__:  re,itertools,baconhameggs
re._parser:  _PATTERNENDERS,SRE_FLAG_UNICODE
array:
types:  __module__,IntType,TypeType
---------------------------------------------------
Modules not imported:
guido.python.ham
baconhameggs
```