analysis.node_visitor

Unified AST Visitor and Transformer base classes.

ProvidesNodeVisitor and NodeTransformerwith automatic visit_<Type>dispatch, eliminating the need for every analysis module to implement its own traversal logic.

Adding a new AST node type requires zero changes to visitor code — generic_visit uses Node.iter_child_nodes()(backed by __dataclass_fields__introspection) to discover children automatically.

Usage::

class MyAnalyzer(NodeVisitor):
    def visit_Name(self, node: Name) -> None:
        print(f"Found name: {node.name}")

    def visit_Filter(self, node: Filter) -> None:
        print(f"Found filter: {node.name}")
        self.generic_visit(node)  # visit children too

class MyOptimizer(NodeTransformer):
    def visit_Const(self, node: Const) -> Node:
        if isinstance(node.value, str):
            return Const(lineno=node.lineno, col_offset=node.col_offset,
                         value=node.value.upper())
        return node