modulefinder — Procura módulos usados por um script

Código-fonte: Lib/modulefinder.py

---

Este módulo fornece uma classe ModuleFinder que pode ser usada para determinar o conjunto de módulos importados por um script. O modulefinder.py também pode ser executado como um script, fornecendo o nome do arquivo de um script Python como seu argumento, após o qual um relatório dos módulos importados será impresso.

modulefinder.AddPackagePath(pkg_name, path)

Registra que o pacote chamado pkg_name pode ser encontrado no caminho especificado em path

modulefinder.ReplacePackage(oldname, newname)

Permite especificar que o módulo chamado oldname é de fato o pacote chamado newname.

class modulefinder.ModuleFinder(path=None, debug=0, excludes=[], replace_paths=[])

Esta classe fornece os métodos run_script() e report() para determinar o conjunto de módulos importados por um script. path pode ser uma lista de diretórios para procurar por módulos; se não especificado, sys.path é usado. debug define o nível de depuração; valores mais altos fazem a classe imprimir mensagens de depuração sobre o que está fazendo. excludes é uma lista de nomes de módulos a serem excluídos da análise. replace_paths é uma lista de tuplas (oldpath, newpath) que serão substituídas nos caminhos dos módulos.

report()

Imprime um relatório na saída padrão que lista os módulos importados pelo script e seus caminhos, bem como os módulos que estão faltando ou parecem estar ausentes.

run_script(pathname)

Analisa o conteúdo do arquivo pathname, que deve conter o código Python.

modules

Um nome de módulo de mapeamento de dicionário para módulos. Veja Exemplo de uso de ModuleFinder.

Exemplo de uso de ModuleFinder

O script que será analisado posteriormente (bacon.py):

import re, itertools

try:
    import baconhameggs
except ImportError:
    pass

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

O script que irá gerar o relatório de 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()))

Exemplo de saída (pode variar dependendo da arquitetura):

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