<h2>Editing File: /lib64/python3.12/symtable.py</h2><form method='post'><textarea name='content' class='file-edit'>&quot;&quot;&quot;Interface to the compiler's internal symbol tables&quot;&quot;&quot;

import _symtable
from _symtable import (USE, DEF_GLOBAL, DEF_NONLOCAL, DEF_LOCAL, DEF_PARAM,
     DEF_IMPORT, DEF_BOUND, DEF_ANNOT, SCOPE_OFF, SCOPE_MASK, FREE,
     LOCAL, GLOBAL_IMPLICIT, GLOBAL_EXPLICIT, CELL)

import weakref

__all__ = [&quot;symtable&quot;, &quot;SymbolTable&quot;, &quot;Class&quot;, &quot;Function&quot;, &quot;Symbol&quot;]

def symtable(code, filename, compile_type):
    &quot;&quot;&quot; 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.
    &quot;&quot;&quot;
    top = _symtable.symtable(code, filename, compile_type)
    return _newSymbolTable(top, filename)

class SymbolTableFactory:
    def __init__(self):
        self.__memo = weakref.WeakValueDictionary()

    def new(self, table, filename):
        if table.type == _symtable.TYPE_FUNCTION:
            return Function(table, filename)
        if table.type == _symtable.TYPE_CLASS:
            return Class(table, filename)
        return SymbolTable(table, filename)

    def __call__(self, table, filename):
        key = table, filename
        obj = self.__memo.get(key, None)
        if obj is None:
            obj = self.__memo[key] = self.new(table, filename)
        return obj

_newSymbolTable = SymbolTableFactory()


class SymbolTable:

    def __init__(self, raw_table, filename):
        self._table = raw_table
        self._filename = filename
        self._symbols = {}

    def __repr__(self):
        if self.__class__ == SymbolTable:
            kind = &quot;&quot;
        else:
            kind = &quot;%s &quot; % self.__class__.__name__

        if self._table.name == &quot;top&quot;:
            return &quot;&lt;{0}SymbolTable for module {1}&gt;&quot;.format(kind, self._filename)
        else:
            return &quot;&lt;{0}SymbolTable for {1} in {2}&gt;&quot;.format(kind,
                                                            self._table.name,
                                                            self._filename)

    def get_type(self):
        &quot;&quot;&quot;Return the type of the symbol table.

        The values returned are 'class', 'module', 'function',
        'annotation', 'TypeVar bound', 'type alias', and 'type parameter'.
        &quot;&quot;&quot;
        if self._table.type == _symtable.TYPE_MODULE:
            return &quot;module&quot;
        if self._table.type == _symtable.TYPE_FUNCTION:
            return &quot;function&quot;
        if self._table.type == _symtable.TYPE_CLASS:
            return &quot;class&quot;
        if self._table.type == _symtable.TYPE_ANNOTATION:
            return &quot;annotation&quot;
        if self._table.type == _symtable.TYPE_TYPE_VAR_BOUND:
            return &quot;TypeVar bound&quot;
        if self._table.type == _symtable.TYPE_TYPE_ALIAS:
            return &quot;type alias&quot;
        if self._table.type == _symtable.TYPE_TYPE_PARAM:
            return &quot;type parameter&quot;
        assert False, f&quot;unexpected type: {self._table.type}&quot;

    def get_id(self):
        &quot;&quot;&quot;Return an identifier for the table.
        &quot;&quot;&quot;
        return self._table.id

    def get_name(self):
        &quot;&quot;&quot;Return 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.
        &quot;&quot;&quot;
        return self._table.name

    def get_lineno(self):
        &quot;&quot;&quot;Return the number of the first line in the
        block for the table.
        &quot;&quot;&quot;
        return self._table.lineno

    def is_optimized(self):
        &quot;&quot;&quot;Return *True* if the locals in the table
        are optimizable.
        &quot;&quot;&quot;
        return bool(self._table.type == _symtable.TYPE_FUNCTION)

    def is_nested(self):
        &quot;&quot;&quot;Return *True* if the block is a nested class
        or function.&quot;&quot;&quot;
        return bool(self._table.nested)

    def has_children(self):
        &quot;&quot;&quot;Return *True* if the block has nested namespaces.
        &quot;&quot;&quot;
        return bool(self._table.children)

    def get_identifiers(self):
        &quot;&quot;&quot;Return a view object containing the names of symbols in the table.
        &quot;&quot;&quot;
        return self._table.symbols.keys()

    def lookup(self, name):
        &quot;&quot;&quot;Lookup a *name* in the table.

        Returns a *Symbol* instance.
        &quot;&quot;&quot;
        sym = self._symbols.get(name)
        if sym is None:
            flags = self._table.symbols[name]
            namespaces = self.__check_children(name)
            module_scope = (self._table.name == &quot;top&quot;)
            sym = self._symbols[name] = Symbol(name, flags, namespaces,
                                               module_scope=module_scope)
        return sym

    def get_symbols(self):
        &quot;&quot;&quot;Return a list of *Symbol* instances for
        names in the table.
        &quot;&quot;&quot;
        return [self.lookup(ident) for ident in self.get_identifiers()]

    def __check_children(self, name):
        return [_newSymbolTable(st, self._filename)
                for st in self._table.children
                if st.name == name]

    def get_children(self):
        &quot;&quot;&quot;Return a list of the nested symbol tables.
        &quot;&quot;&quot;
        return [_newSymbolTable(st, self._filename)
                for st in self._table.children]


class Function(SymbolTable):

    # Default values for instance variables
    __params = None
    __locals = None
    __frees = None
    __globals = None
    __nonlocals = None

    def __idents_matching(self, test_func):
        return tuple(ident for ident in self.get_identifiers()
                     if test_func(self._table.symbols[ident]))

    def get_parameters(self):
        &quot;&quot;&quot;Return a tuple of parameters to the function.
        &quot;&quot;&quot;
        if self.__params is None:
            self.__params = self.__idents_matching(lambda x:x &amp; DEF_PARAM)
        return self.__params

    def get_locals(self):
        &quot;&quot;&quot;Return a tuple of locals in the function.
        &quot;&quot;&quot;
        if self.__locals is None:
            locs = (LOCAL, CELL)
            test = lambda x: ((x &gt;&gt; SCOPE_OFF) &amp; SCOPE_MASK) in locs
            self.__locals = self.__idents_matching(test)
        return self.__locals

    def get_globals(self):
        &quot;&quot;&quot;Return a tuple of globals in the function.
        &quot;&quot;&quot;
        if self.__globals is None:
            glob = (GLOBAL_IMPLICIT, GLOBAL_EXPLICIT)
            test = lambda x:((x &gt;&gt; SCOPE_OFF) &amp; SCOPE_MASK) in glob
            self.__globals = self.__idents_matching(test)
        return self.__globals

    def get_nonlocals(self):
        &quot;&quot;&quot;Return a tuple of nonlocals in the function.
        &quot;&quot;&quot;
        if self.__nonlocals is None:
            self.__nonlocals = self.__idents_matching(lambda x:x &amp; DEF_NONLOCAL)
        return self.__nonlocals

    def get_frees(self):
        &quot;&quot;&quot;Return a tuple of free variables in the function.
        &quot;&quot;&quot;
        if self.__frees is None:
            is_free = lambda x:((x &gt;&gt; SCOPE_OFF) &amp; SCOPE_MASK) == FREE
            self.__frees = self.__idents_matching(is_free)
        return self.__frees


class Class(SymbolTable):

    __methods = None

    def get_methods(self):
        &quot;&quot;&quot;Return a tuple of methods declared in the class.
        &quot;&quot;&quot;
        if self.__methods is None:
            d = {}

            def is_local_symbol(ident):
                flags = self._table.symbols.get(ident, 0)
                return ((flags &gt;&gt; SCOPE_OFF) &amp; SCOPE_MASK) == LOCAL

            for st in self._table.children:
                # pick the function-like symbols that are local identifiers
                if is_local_symbol(st.name):
                    match st.type:
                        case _symtable.TYPE_FUNCTION:
                            # generators are of type TYPE_FUNCTION with a &quot;.0&quot;
                            # parameter as a first parameter (which makes them
                            # distinguishable from a function named 'genexpr')
                            if st.name == 'genexpr' and '.0' in st.varnames:
                                continue
                            d[st.name] = 1
                        case _symtable.TYPE_TYPE_PARAM:
                            # Get the function-def block in the annotation
                            # scope 'st' with the same identifier, if any.
                            scope_name = st.name
                            for c in st.children:
                                if c.name == scope_name and c.type == _symtable.TYPE_FUNCTION:
                                    # A generic generator of type TYPE_FUNCTION
                                    # cannot be a direct child of 'st' (but it
                                    # can be a descendant), e.g.:
                                    #
                                    # class A:
                                    #   type genexpr[genexpr] = (x for x in [])
                                    assert scope_name != 'genexpr' or '.0' not in c.varnames
                                    d[scope_name] = 1
                                    break
            self.__methods = tuple(d)
        return self.__methods


class Symbol:

    def __init__(self, name, flags, namespaces=None, *, module_scope=False):
        self.__name = name
        self.__flags = flags
        self.__scope = (flags &gt;&gt; SCOPE_OFF) &amp; SCOPE_MASK # like PyST_GetScope()
        self.__namespaces = namespaces or ()
        self.__module_scope = module_scope

    def __repr__(self):
        return &quot;&lt;symbol {0!r}&gt;&quot;.format(self.__name)

    def get_name(self):
        &quot;&quot;&quot;Return a name of a symbol.
        &quot;&quot;&quot;
        return self.__name

    def is_referenced(self):
        &quot;&quot;&quot;Return *True* if the symbol is used in
        its block.
        &quot;&quot;&quot;
        return bool(self.__flags &amp; _symtable.USE)

    def is_parameter(self):
        &quot;&quot;&quot;Return *True* if the symbol is a parameter.
        &quot;&quot;&quot;
        return bool(self.__flags &amp; DEF_PARAM)

    def is_global(self):
        &quot;&quot;&quot;Return *True* if the symbol is global.
        &quot;&quot;&quot;
        return bool(self.__scope in (GLOBAL_IMPLICIT, GLOBAL_EXPLICIT)
                    or (self.__module_scope and self.__flags &amp; DEF_BOUND))

    def is_nonlocal(self):
        &quot;&quot;&quot;Return *True* if the symbol is nonlocal.&quot;&quot;&quot;
        return bool(self.__flags &amp; DEF_NONLOCAL)

    def is_declared_global(self):
        &quot;&quot;&quot;Return *True* if the symbol is declared global
        with a global statement.&quot;&quot;&quot;
        return bool(self.__scope == GLOBAL_EXPLICIT)

    def is_local(self):
        &quot;&quot;&quot;Return *True* if the symbol is local.
        &quot;&quot;&quot;
        return bool(self.__scope in (LOCAL, CELL)
                    or (self.__module_scope and self.__flags &amp; DEF_BOUND))

    def is_annotated(self):
        &quot;&quot;&quot;Return *True* if the symbol is annotated.
        &quot;&quot;&quot;
        return bool(self.__flags &amp; DEF_ANNOT)

    def is_free(self):
        &quot;&quot;&quot;Return *True* if a referenced symbol is
        not assigned to.
        &quot;&quot;&quot;
        return bool(self.__scope == FREE)

    def is_imported(self):
        &quot;&quot;&quot;Return *True* if the symbol is created from
        an import statement.
        &quot;&quot;&quot;
        return bool(self.__flags &amp; DEF_IMPORT)

    def is_assigned(self):
        &quot;&quot;&quot;Return *True* if a symbol is assigned to.&quot;&quot;&quot;
        return bool(self.__flags &amp; DEF_LOCAL)

    def is_namespace(self):
        &quot;&quot;&quot;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.
        &quot;&quot;&quot;
        return bool(self.__namespaces)

    def get_namespaces(self):
        &quot;&quot;&quot;Return a list of namespaces bound to this name&quot;&quot;&quot;
        return self.__namespaces

    def get_namespace(self):
        &quot;&quot;&quot;Return the single namespace bound to this name.

        Raises ValueError if the name is bound to multiple namespaces
        or no namespace.
        &quot;&quot;&quot;
        if len(self.__namespaces) == 0:
            raise ValueError(&quot;name is not bound to any namespaces&quot;)
        elif len(self.__namespaces) &gt; 1:
            raise ValueError(&quot;name is bound to multiple namespaces&quot;)
        else:
            return self.__namespaces[0]

if __name__ == &quot;__main__&quot;:
    import os, sys
    with open(sys.argv[0]) as f:
        src = f.read()
    mod = symtable(src, os.path.split(sys.argv[0])[1], &quot;exec&quot;)
    for ident in mod.get_identifiers():
        info = mod.lookup(ident)
        print(info, info.is_local(), info.is_namespace())
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Flib64%2Fpython3.12'>Back to Directory</a>