symtable — Acceso a la tabla de símbolos del compilador

Código fuente: Lib/symtable.py

Las tablas de símbolos son generadas por el compilador a partir del AST justo antes de que el bytecode sea generado. La tabla de símbolos es responsable de calcular el ámbito de cada identificador en el código. symtable provee una interfaz para examinar esas tablas.

Generando tablas de símbolos

symtable.symtable(code, filename, compile_type)

Retorna la SymbolTable del nivel más alto para el código Python code. filename es el nombre del archivo conteniendo el código. compile_type es como el argumento mode de la función compile().

Examinando la tabla de símbolos

class symtable.SymbolTable

Un espacio de nombres para el bloque. El constructor no es público.

get_type()

Return the type of the symbol table. Possible values are 'class', 'module', 'function', 'annotation', 'TypeVar bound', 'type alias', and 'type parameter'. The latter four refer to different flavors of annotation scopes.

Distinto en la versión 3.12: Added 'annotation', 'TypeVar bound', 'type alias', and 'type parameter' as possible return values.

get_id()

Retorna el identificador de la tabla.

get_name()

Return the table’s name. This is the name of the class if the table is for a class, the name of the function if the table is for a function, or 'top' if the table is global (get_type() returns 'module'). For type parameter scopes (which are used for generic classes, functions, and type aliases), it is the name of the underlying class, function, or type alias. For type alias scopes, it is the name of the type alias. For TypeVar bound scopes, it is the name of the TypeVar.

get_lineno()

Retorna el número de la primera línea en el bloque que esta tabla representa.

is_optimized()

Retorna True si los locales en esta tabla pueden ser optimizados.

is_nested()

Retorna True si el bloque es una clase o función anidadas.

has_children()

Retorna True si el bloque contiene espacios de nombres anidados en él. Estos pueden ser obtenidos con get_children().

get_identifiers()

Retorna una vista de objeto que contiene los nombres de los símbolos en la tabla. Lee la documentación de vistas de objetos.

lookup(name)

Busca name en la tabla y retorna una instancia de Symbol.

get_symbols()

Retorna una lista de instancias de Symbol de los nombres en la tabla.

get_children()

Retorna una lista de las tablas de símbolos anidadas.

class symtable.Function

A namespace for a function or method. This class inherits from SymbolTable.

get_parameters()

Retorna una tupla conteniendo los nombres de los parámetros de esta función.

get_locals()

Retorna una tupla conteniendo los nombres de los locales en esta función.

get_globals()

Retorna una tupla conteniendo los nombres de los globales en esta función.

get_nonlocals()

Retorna una tupla conteniendo los nombres de los no locales en esta función.

get_frees()

Retorna una tupla conteniendo los nombres de las variables libres en esta función.

class symtable.Class

A namespace of a class. This class inherits from SymbolTable.

get_methods()

Retorna una tupla conteniendo los nombres de los métodos declarados en la clase.

class symtable.Symbol

Una entrada en una SymbolTable correspondiente a un identificador en el código. El constructor no es público.

get_name()

Retorna el nombre del símbolo.

is_referenced()

Retorna True si el símbolo es usado en su bloque.

is_imported()

Retorna True si el símbolo es creado desde una instrucción import.

is_parameter()

Retorna True si el símbolo es un parámetro.

is_global()

Retorna True si el símbolo es global.

is_nonlocal()

Retorna True si el símbolo es no local.

is_declared_global()

Retorna True si el símbolo es declarado global con una instrucción global.

is_local()

Retorna True si el símbolo es local a su bloque.

is_annotated()

Retorna True si el símbolo está anotado.

Nuevo en la versión 3.6.

is_free()

Retorna True si el símbolo es referenciado en su bloque pero no asignado.

is_assigned()

Retorna True si el símbolo es asignado en su bloque.

is_namespace()

Retorna True si la vinculación de nombres introduce un nuevo espacio de nombres.

Si el nombre es usado como objetivo de una instrucción function o class retornará verdadero.

Por ejemplo:

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

Note que un solo nombre puede estar vinculado a varios objetos. Si el resultado es True, el nombre puede estar vinculado también a otros objetos, como un entero o una lista, esto no introduce un nuevo espacio de nombres.

get_namespaces()

Retorna una lista de espacios de nombres vinculados a este nombre.

get_namespace()

Retorna el espacio de nombre vinculado a este nombre. Si hay más de un espacio de nombre vinculado o ninguno a ese nombre se levanta un ValueError.