# 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