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

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

Новое в версии 2.3.

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


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

modulefinder.AddPackagePath(pkg_name, path)

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

modulefinder.ReplacePackage(oldname, newname)

Позволяет указать, что модуль с именем oldname на самом деле является пакетом с именем newname. Наиболее распространённый вариант использования – обработка того, как пакет _xmlplus заменяет пакет xml.

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.

31.6.1. Пример использования 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.iteritems():
    print '%s: ' % name,
    print ','.join(mod.globalnames.keys()[:3])

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

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

Loaded modules:
_types:
copy_reg:  _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