pyclbr — Suporte a navegador de módulos do Python

Código-fonte: Lib/pyclbr.py


O módulo pyclbr fornece informações limitadas sobre as funções, classes e métodos definidos em um módulo codificado em Python. As informações são suficientes para implementar um navegador de módulos. As informações são extraídas do código-fonte do Python em vez de importar o módulo, portanto, este módulo é seguro para uso com código não confiável. Essa restrição torna impossível o uso deste módulo com módulos não implementados no Python, incluindo todos os módulos de extensão padrão e opcionais.

pyclbr.readmodule(module, path=None)

Retorna um dicionário que mapeia os nomes de classe no nível do módulo aos descritores de classe. Se possível, descritores para classes base importadas estão incluídos. O parâmetro module é uma string com o nome do módulo a ser lido; pode ser o nome de um módulo dentro de um pacote. Se fornecido, path é uma sequência de caminhos de diretório anexada a sys.path, que é usada para localizar o código-fonte do módulo.

Esta função é a interface original e é mantida apenas para compatibilidade reversa. Ela retorna uma versão filtrada da seguinte.

pyclbr.readmodule_ex(module, path=None)

Retorna uma árvore baseada em dicionário que contém uma função ou descritores de classe para cada função e classe definida no módulo com uma instrução def ou class. O dicionário retornado mapeia os nomes das funções e das classes no nível do módulo para seus descritores. Objetos aninhados são inseridos no dicionário filho de seus pais. Como em readmodule, module nomeia o módulo a ser lido e path é anexado ao sys.path. Se o módulo que está sendo lido for um pacote, o dicionário retornado terá uma chave '__path__' cujo valor é uma lista que contém o caminho de pesquisa do pacote.

Novo na versão 3.7: Descritores para definições aninhadas. Eles são acessados através do novo atributo filho. Cada um tem um novo atributo pai.

Os descritores retornados por essas funções são instâncias das classes Function e Class. Não se espera que os usuários criem instâncias dessas classes.

Objetos de Function

Instâncias da classe Function descrevem funções definidas por instruções def. Elas têm os seguintes atributos:

Function.file

Nome do arquivo no qual a função está definida.

Function.module

O nome do módulo que define a função descrita.

Function.name

O nome da função.

Function.lineno

O número da linha no arquivo em que a definição é iniciada.

Function.parent

Para funções de nível superior, None. Para funções aninhadas, o pai.

Novo na versão 3.7.

Function.children

Um dicionário que mapeia nomes para descritores para funções e classes aninhadas.

Novo na versão 3.7.

Objetos de Class

Instâncias da classe Class descrevem classes definidas por instruções class. Elas têm os mesmos atributos que Functions e mais dois.

Class.file

Nome do arquivo no qual a classe está definida.

Class.module

O nome do módulo que define a classe descrita.

Class.name

O nome da classe.

Class.lineno

O número da linha no arquivo em que a definição é iniciada.

Class.parent

Para classes de nível superior, None. Para classes aninhadas, o pai.

Novo na versão 3.7.

Class.children

Um dicionário que mapeia nomes para descritores para funções e classes aninhadas.

Novo na versão 3.7.

Class.super

Uma lista de objetos Class que descreve as classes base imediatas da classe que está sendo descrita. Classes nomeadas como superclasses, mas que não podem ser descobertas por readmodule_ex() são listadas como uma string com o nome da classe em vez de como objetos de Class.

Class.methods

Um dicionário que mapeia nomes de métodos para números de linha. Isso pode ser derivado do dicionário filho mais novo, mas permanece para compatibilidade retroativa.