symtable — Доступ к таблицам символов компилятора

Генерация таблиц символов

symtable.symtable(code, filename, compile_type)

Возвращает глобальную SymbolTable для исходного Python-кода. filename — имя файла, содержащего код. compile_type аналогичен аргументу mode в compile().

Просмотр таблиц символов

class symtable.SymbolTable

Таблица имен пространства имён для блока. Конструктор не является общедоступным.

get_type()

Возвращает тип таблицы символов. Возможные значения — 'class', 'module', и 'function'.

get_id()

Возвращает идентификатор таблицы.

get_name()

Возвращает имя таблицы. Это имя класса, если таблица относится к классу, имя функции, если таблица относится к функции, или 'top', если таблица глобальная (get_type() возвращает 'module').

get_lineno()

Возвращает номер первой строки в блоке, который представляет эта таблица.

is_optimized()

Возвращает True, если локальные переменные в этой таблице могут быть оптимизированы.

is_nested()

Возвращает True, если блок является вложенным классом или функцией.

has_children()

Возвращает True, если блок содержит вложенные пространства имён. Их можно получить с помощью get_children().

get_identifiers()

Возвращает объект-представление, содержащий имена символов в таблице. См. документацию по объектам-представлениям.

lookup(name)

Ищет name в таблице и возвращает экземпляр Symbol.

get_symbols()

Возвращает список экземпляров Symbol для имён в таблице.

get_children()

Возвращает список вложенных таблиц символов.

class symtable.Function

Пространство имён для функции или метода. Этот класс наследует SymbolTable.

get_parameters()

Возвращает кортеж, содержащий имена параметров этой функции.

get_locals()

Возвращает кортеж, содержащий имена локальных переменных в этой функции.

get_globals()

Возвращает кортеж, содержащий имена глобальных переменных в этой функции.

get_nonlocals()

Возвращает кортеж, содержащий имена нелокальных переменных в этой функции.

get_frees()

Возвращает кортеж, содержащий имена свободных переменных в этой функции.

class symtable.Class

Пространство имён класса. Этот класс наследует SymbolTable.

get_methods()

Возвращает кортеж, содержащий имена методов, объявленных в классе.

class symtable.Symbol

Элемент в SymbolTable, соответствующий идентификатору в исходном коде. Конструктор не является общедоступным.

get_name()

Возвращает имя символа.

is_referenced()

Возвращает True, если символ используется в своём блоке.

is_imported()

Возвращает True, если символ создан из оператора импорта.

is_parameter()

Возвращает True, если символ является параметром.

is_global()

Возвращает True, если символ является глобальным.

is_nonlocal()

Возвращает True, если символ является нелокальным.

is_declared_global()

Возвращает True, если символ объявлен глобальным с помощью оператора global.

is_local()

Возвращает True, если символ локален для своего блока.

is_annotated()

Возвращает True, если символ аннотирован.

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

is_free()

Возвращает True, если символ ссылается на свой блок, но не присваивается.

is_assigned()

Возвращает True, если символу присваивается значение в его блоке.

is_namespace()

Возвращает True, если привязка имени вводит новое пространство имён.

Это будет true, если имя используется в качестве целевого оператора функции или класса.

Например:

>>> table = symtable.symtable("def some_func(): pass", "string", "exec")
>>> table.lookup("some_func").is_namespace()
True

Обратите внимание, что одно имя может быть привязано к нескольким объектам. Если результат True, имя также может быть привязано к другим объектам, таким как int или список, которые не вводят новое пространство имён.

get_namespaces()

Возвращает список пространств имён, привязанных к этому имени.

get_namespace()

Возвращает пространство имён, привязанное к этому имени. Если к этому имени привязано более одного или нет пространств имён, возникает ValueError.