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

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

Экземпляры класса 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 описывают классы, определённые оператором class. У них есть те же атрибуты, что и у функций, а также два дополнительных.

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, но он сохраняется для обратной совместимости.