Документация Python неофициальный перевод
Содержание страницы

pyclbr – поддержка браузера модулей Pythonpyclbr – Python module browser support

Исходный код: 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. Пользователи не должны создавать экземпляры этих классов.

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

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

Function.file

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

Function.module

Имя модуля, определяющего описываемую функцию.

Function.name

Имя функции.

Function.lineno

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

Function.parent

Для функций верхнего уровня – None. Для вложенных функций – родитель.

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

Function.children

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

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

Function.is_async

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

Новое в версии 3.10.

Объекты классаClass Objects

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

Class.file

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

Class.module

Имя модуля, определяющего описываемый класс.

Class.name

Имя класса.

Class.lineno

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

Class.parent

Для классов верхнего уровня – None. Для вложенных классов – родительский.

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

Class.children

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

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

Class.super

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

Class.methods

Словарь, сопоставляющий имена методов с номерами строк. Его можно получить из более нового словаря children, но он сохранён для обратной совместимости.