modulefinder — Поиск модулей


Модуль предоставляет класс ModuleFinder, используемый для определения набора импортируемых сценарием модулей. modulefinder.py также можно запустить как скрипт, указав имя файла скрипта Python в качестве аргумента, после чего будет напечатан отчёт об импортированных модулях.

modulefinder.AddPackagePath(pkg_name, path)

Записывает, что пакет с именем pkg_name можно найти в указанном path.

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.

Пример использования 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('Модули не импортированы:')
print('\n'.join(finder.badmodules.keys()))

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

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:  _PATTERNENDERS,SRE_FLAG_UNICODE
array:
types:  __module__,IntType,TypeType
---------------------------------------------------
Modules not imported:
guido.python.ham
baconhameggs