31.3. 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)

分析路径名文件的内容，该文件必须包含Python代码。

modules

字典映射模块命名为模块。请参阅Example usage of ModuleFinder。

31.3.1. Example 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__
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