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óncompile()
.
Examinando la tabla de símbolos¶
-
class
symtable.
SymbolTable
¶ Un espacio de nombres para el bloque. El constructor no es público.
-
get_type
()¶ Retorna el tipo de la tabla de símbolos. Los valores posibles son
'class'
,'module'
y'function'
.
-
get_id
()¶ Retorna el identificador de la tabla.
-
get_name
()¶ Retorna el nombre de la tabla. Este es el nombre de la clase si la tabla es para una clase, el nombre de la función si la tabla es para una función, o
'top'
si la tabla es global (get_type()
retorna'module'
).
-
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 conget_children()
.
-
has_exec
()¶ Retorna
True
si el bloque usaexec
.
-
get_identifiers
()¶ Retorna una lista con los nombres de los símbolos en esta tabla.
-
get_children
()¶ Retorna una lista de las tablas de símbolos anidadas.
-
-
class
symtable.
Function
¶ Un espacio de nombres para una función o método. Esta clase hereda de
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
¶ Un espacio de nombres de una clase. Esta clase hereda de
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
()¶ Return
True
if the symbol is annotated.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 nombres vinculado a este nombre. Si más de un espacio de nombres esta vinculado se lanza un
ValueError
.
-