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

---

# 29.4. `modulefinder` – Поиск модулей, используемых скриптом

Этот модуль предоставляет класс [`ModuleFinder`](https://python-all.ru/3.1/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.1/library/modulefinder.html#modulefinder.ModuleFinder.run_script) и [`report()`](https://python-all.ru/3.1/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.1/library/modulefinder.html#modulefinder-example)

## 29.4.1. Пример использования [`ModuleFinder`](https://python-all.ru/3.1/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__
sre_compile:  isstring,_sre,_optimize_unicode
_sre:
sre_constants:  REPEAT_ONE,makedict,AT_END_LINE
sys:
re:  __module__,finditer,_expand
itertools:
__main__:  re,itertools,baconhameggs
sre_parse:  __getslice__,_PATTERNENDERS,SRE_FLAG_UNICODE
array:
types:  __module__,IntType,TypeType
---------------------------------------------------
Modules not imported:
guido.python.ham
baconhameggs
```