pyclbr — поддержка браузера модулей Python

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

Модуль pyclbr предоставляет ограниченную информацию о функциях, классах и методах, определённых в модуле, написанном на Python. Этой информации достаточно для реализации браузера модулей. Информация извлекается из исходного кода Python, а не путём импорта модуля, поэтому этот модуль безопасно использовать с недоверенным кодом. Это ограничение не позволяет использовать данный модуль с модулями, не реализованными на Python, включая все стандартные и дополнительные модули расширений.

pyclbr.readmodule(module, path=None)

Возвращает словарь, сопоставляющий имена классов уровня модуля с дескрипторами классов. Если возможно, включаются дескрипторы импортированных базовых классов. Параметр module — это строка с именем читаемого модуля; это может быть имя модуля внутри пакета. Если указан параметр path, это последовательность путей к каталогам, добавляемых в начало sys.path, который используется для поиска исходного кода модуля.

Эта функция является исходным интерфейсом и сохранена только для обратной совместимости. Она возвращает отфильтрованную версию следующего объекта.

pyclbr.readmodule_ex(module, path=None): Возвращает дерево на основе словаря, содержащее дескрипторы функций или классов для каждой функции и каждого класса, определённых в модуле с помощью оператора def или class. Возвращённый словарь сопоставляет имена функций и классов уровня модуля с их дескрипторами. Вложенные объекты помещаются в словарь children своего родителя. Как и в readmodule, module задаёт имя читаемого модуля, а path добавляется в начало sys.path. Если читаемый модуль является пакетом, возвращённый словарь содержит ключ '__path__', значением которого является список путей поиска пакета.

Добавлено в версии 3.7: Дескрипторы вложенных определений. Доступ к ним осуществляется через новый атрибут children. У каждого из них есть новый атрибут parent.

Дескрипторы, возвращаемые этими функциями, являются экземплярами классов Function и Class. Пользователям не предполагается создавать экземпляры этих классов.

Объекты функций

class pyclbr.Function

Экземпляры класса Function описывают функции, определённые операторами def. Они имеют следующие атрибуты:

file: Имя файла, в котором определена функция.

module: Имя модуля, в котором определена описываемая функция.

name: Имя функции.

lineno: Номер строки файла, с которой начинается определение.

parent: Для функций верхнего уровня — None. Для вложенных функций — родительский объект.

Добавлено в версии 3.7.

children: Сопоставление имён с дескрипторами вложенных функций и классов в виде dictionary.

Добавлено в версии 3.7.

is_async: True для функций, определённых с префиксом async, и False в противном случае.

Добавлено в версии 3.10.

Объекты классов

class pyclbr.Class

Экземпляры класса Class описывают классы, определённые операторами class. Они имеют те же атрибуты, что и Functions, и ещё два дополнительных.

file: Имя файла, в котором определён класс.

module: Имя модуля, в котором определён описываемый класс.

name: Имя класса.

lineno: Номер строки файла, с которой начинается определение.

parent: Для классов верхнего уровня — None. Для вложенных классов — родительский объект.

Добавлено в версии 3.7.

children: Словарь, сопоставляющий имена с дескрипторами вложенных функций и классов.

Добавлено в версии 3.7.

super: Список объектов Class, описывающих непосредственные базовые классы описываемого класса. Классы, указанные как суперклассы, но не обнаруживаемые с помощью readmodule_ex(), перечисляются в виде строк с именами классов, а не объектов Class.

methods: Сопоставление имён методов с номерами строк в виде dictionary. Эти данные можно получить из более нового словаря children, но атрибут сохранён для обратной совместимости.