o
0i' @ sX d Z ddlZddlmZmZmZmZmZmZmZm Z m
Z
m Z m Z m
Z
mZmZmZ ddlZg dZdd ZG dd dZe ZG d d
d
ZG d d d eZG d
d deZG dd dZedkrddlZddl Z e e j d Z e Z!W d n1 s~w Y ee!ej"#e j d d dZ$e$% D ]Z&e$'e&Z(e)e(e(* e(+ qdS dS )z2Interface to the compiler's internal symbol tables N)USE
DEF_GLOBAL DEF_NONLOCAL DEF_LOCAL DEF_PARAM
DEF_IMPORT DEF_BOUND DEF_ANNOT SCOPE_OFF
SCOPE_MASKFREELOCALGLOBAL_IMPLICITGLOBAL_EXPLICITCELL)symtable SymbolTableClassFunctionSymbolc C s t | ||}t||S )z Return the toplevel *SymbolTable* for the source code.
*filename* is the name of the file with the code
and *compile_type* is the *compile()* mode argument.
) _symtabler _newSymbolTable)codefilenameZ compile_typetop r //opt/alt/python310/lib64/python3.10/symtable.pyr s
r c @ s$ e Zd Zdd Zdd Zdd ZdS )SymbolTableFactoryc C s t | _d S N)weakrefZWeakValueDictionary_SymbolTableFactory__memoselfr r r __init__ s zSymbolTableFactory.__init__c C s6 |j tjkr t||S |j tjkrt||S t||S r )typer
TYPE_FUNCTIONr
TYPE_CLASSr r )r" tabler r r r new s
zSymbolTableFactory.newc C s8 ||f}| j |d }|d u r| || }| j |< |S r )r getr( )r" r' r keyobjr r r __call__ s
zSymbolTableFactory.__call__N)__name__
__module__ __qualname__r# r( r, r r r r r s r c @ s| e Zd Zdd Zdd Zdd Zdd Zd d
Zd d Zd
d Z dd Z
dd Z dd Z dd Z
dd Zdd Zdd Zd S ) r c C s || _ || _i | _d S r )_table _filename_symbols)r" Z raw_tabler r r r r# , s
zSymbolTable.__init__c C sJ | j tkrd}nd| j j }| jjdkrd|| jS d|| jj| jS )N z%s r z <{0}SymbolTable for module {1}>z <{0}SymbolTable for {1} in {2}>) __class__r r- r0 nameformatr1 )r" kindr r r __repr__1 s
zSymbolTable.__repr__c C sX | j jtjkr dS | j jtjkrdS | j jtjkrdS | j jdv s*J d| j jdS )zwReturn the type of the symbol table.
The values retuned are 'class', 'module' and
'function'.
moduleZfunctionclass) zunexpected type: {0}N)r0 r$ r Z TYPE_MODULEr% r& r6 r! r r r get_type> s zSymbolTable.get_typec C | j jS )z,Return an identifier for the table.
)r0 idr! r r r get_idM s zSymbolTable.get_idc C r? )zReturn the table's name.
This corresponds to the name of the class, function
or 'top' if the table is for a class, function or
global respectively.
)r0 r5 r! r r r get_nameR s zSymbolTable.get_namec C r? )zPReturn the number of the first line in the
block for the table.
)r0 linenor! r r r
get_lineno[ s zSymbolTable.get_linenoc C s t | jjtjkS )zJReturn *True* if the locals in the table
are optimizable.
)boolr0 r$ r r% r! r r r is_optimizeda s zSymbolTable.is_optimizedc C t | jjS )zAReturn *True* if the block is a nested class
or function.)rE r0 nestedr! r r r is_nestedg zSymbolTable.is_nestedc C rG )z:Return *True* if the block has nested namespaces.
)rE r0 childrenr! r r r has_childrenl rJ zSymbolTable.has_childrenc C s | j j S )zKReturn a view object containing the names of symbols in the table.
)r0 symbolskeysr! r r r get_identifiersq rJ zSymbolTable.get_identifiersc C sT | j |}|du r(| jj| }| |}| jjdk}t||||d }| j |< |S )zLLookup a *name* in the table.
Returns a *Symbol* instance.
Nr module_scope)r2 r) r0 rM _SymbolTable__check_childrenr5 r )r" r5 Zsymflags
namespacesrQ r r r lookupv s
zSymbolTable.lookupc s fdd D S )zLReturn a list of *Symbol* instances for
names in the table.
c s g | ]} |qS r )rU .0identr! r r
s z+SymbolTable.get_symbols..)rO r! r r! r get_symbols s zSymbolTable.get_symbolsc s fddj jD S )Nc s" g | ]
}|j krt|jqS r )r5 r r1 rW str5 r" r r rY s
z0SymbolTable.__check_children..r0 rK )r" r5 r r] r Z__check_children s z SymbolTable.__check_childrenc s fdd j jD S )z3Return a list of the nested symbol tables.
c s g | ]}t | jqS r )r r1 r[ r! r r rY s z,SymbolTable.get_children..r^ r! r r! r get_children s
zSymbolTable.get_childrenN)r- r. r/ r# r8 r> rA rB rD rF rI rL rO rU rZ rR r_ r r r r r * s
r c @ sP e Zd ZdZdZdZdZdZdd Zdd Z dd Z
dd Z d
d Z d d
Z
dS )r Nc s t fdd D S )Nc 3 s$ | ]
} j j| r|V qd S r )r0 rM rV r" Z test_funcr r s z-Function.__idents_matching..)tuplerO r` r r` r Z__idents_matching s zFunction.__idents_matchingc C | j du r
| dd | _ | j S )z6Return a tuple of parameters to the function.
Nc S | t @ S r )r xr r r z)Function.get_parameters..)_Function__params_Function__idents_matchingr! r r r get_parameters
zFunction.get_parametersc 0 | j du rttf fdd}| || _ | j S )z2Return a tuple of locals in the function.
Nc | t ? t@ v S r r
r re Zlocsr r rg z%Function.get_locals..)_Function__localsr
r rj r" testr rp r
get_locals
zFunction.get_localsc rm )z3Return a tuple of globals in the function.
Nc rn r ro re Zglobr r rg rq z&Function.get_globals..)_Function__globalsr r rj rs r rw r get_globals rv zFunction.get_globalsc C rc )z5Return a tuple of nonlocals in the function.
Nc S rd r )r re r r r rg rh z(Function.get_nonlocals..)_Function__nonlocalsrj r! r r r
get_nonlocals rl zFunction.get_nonlocalsc C s$ | j du rdd }| || _ | j S )z:Return a tuple of free variables in the function.
Nc S s | t ? t@ tkS r )r
r r re r r r rg rq z$Function.get_frees..)_Function__freesrj )r" is_freer r r get_frees s
zFunction.get_frees)r- r. r/ ri rr r| rx rz rj rk ru ry r{ r~ r r r r r s r c @ s e Zd ZdZdd ZdS )r Nc C s6 | j du ri }| jjD ]}d||j< q t|| _ | j S )z9Return a tuple of methods declared in the class.
Nr; )_Class__methodsr0 rK r5 rb )r" dr\ r r r get_methods s
zClass.get_methods)r- r. r/ r r r r r r r s r c @ s e Zd Zd$ddddZdd Zdd Zd
d Zd d
Zdd Zdd Z dd Z
dd Z dd Z dd Z
dd Zd d Zd d Zd d! Zd"d# ZdS )%r NFrP c C s. || _ || _|t? t@ | _|pd| _|| _d S )Nr )
_Symbol__name_Symbol__flagsr
r _Symbol__scope_Symbol__namespaces_Symbol__module_scope)r" r5 rS rT rQ r r r r# s
zSymbol.__init__c C s d | jS )Nz)r6 r r! r r r r8 s zSymbol.__repr__c C | j S )z#Return a name of a symbol.
)r r! r r r rB s zSymbol.get_namec C s t | jtj@ S )zBReturn *True* if the symbol is used in
its block.
)rE r r r r! r r r
is_referenced s zSymbol.is_referencedc C t | jt@ S )z4Return *True* if the symbol is a parameter.
)rE r r r! r r r is_parameter zSymbol.is_parameterc C " t | jttfv p| jo| jt@ S )z0Return *True* if the sysmbol is global.
)rE r r r r r r r! r r r is_global zSymbol.is_globalc C r )z(Return *True* if the symbol is nonlocal.)rE r r r! r r r is_nonlocal zSymbol.is_nonlocalc C t | jtkS )zOReturn *True* if the symbol is declared global
with a global statement.)rE r r r! r r r is_declared_global r zSymbol.is_declared_globalc C r )z.Return *True* if the symbol is local.
)rE r r
r r r r r! r r r is_local r zSymbol.is_localc C r )z2Return *True* if the symbol is annotated.
)rE r r r! r r r is_annotated r zSymbol.is_annotatedc C r )zIReturn *True* if a referenced symbol is
not assigned to.
)rE r r r! r r r r} zSymbol.is_freec C r )zQReturn *True* if the symbol is created from
an import statement.
)rE r r r! r r r is_imported r zSymbol.is_importedc C r )z)Return *True* if a symbol is assigned to.)rE r r r! r r r is_assigned r zSymbol.is_assignedc C s
t | jS )a Returns *True* if name binding introduces new namespace.
If the name is used as the target of a function or class
statement, this will be true.
Note that a single name can be bound to multiple objects. If
is_namespace() is true, the name may also be bound to other
objects, like an int or list, that does not introduce a new
namespace.
)rE r r! r r r is_namespace! s
zSymbol.is_namespacec C r )z.Return a list of namespaces bound to this name)r r! r r r get_namespaces. s zSymbol.get_namespacesc C s t | jdkr td| jd S )zReturn the single namespace bound to this name.
Raises ValueError if the name is bound to multiple namespaces.
r; z$name is bound to multiple namespacesr )lenr
ValueErrorr! r r r
get_namespace2 s
zSymbol.get_namespacer )r- r. r/ r# r8 rB r r r r r r r r} r r r r r r r r r r s"
r __main__r; exec),__doc__r r r r r r r r r r
r r r
r r r r __all__r r r r r r r r- ossysopenargvfreadsrcpathsplitmodrO rX rU infoprintr r r r r r s. D l6`