Документация Python неофициальный перевод
Содержание страницы

modulefinder – Поиск модулей, используемых сценариемmodulefinder – Find modules used by a script

Исходный код: Lib/modulefinder.py


Этот модуль предоставляет класс 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() и report() для определения набора модулей, импортированных сценарием. path может быть списком каталогов для поиска модулей; если не указан, используется sys.path. debug задаёт уровень отладки; более высокие значения заставляют класс выводить отладочные сообщения о том, что он делает. excludes – это список имён модулей, исключаемых из анализа. replace_paths – это список кортежей (oldpath, newpath), которые будут заменены в путях модулей.

report()

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

run_script(pathname)

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

modules

Словарь, сопоставляющий имена модулей с модулями. См. Пример использования ModuleFinder.

Пример использования ModuleFinderExample usage of ModuleFinder

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

import re, itertools

try:
    import baconhameggs
except ImportError:
    pass

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

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

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()))

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

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