codegen

Extension to ast that allow ast -> python code generation.

copyright:Copyright 2008 by Armin Ronacher. license:BSD.

class core.codegen.SourceGenerator(indent_with, add_line_information=False)

Bases: ast.NodeVisitor

This visitor is able to transform a well formed syntax tree into python sourcecode. For more details have a look at the docstring of the node_to_source function.

body(statements)

body_or_else(node)

decorators(node)

newline(node=None, extra=0)

signature(node)

visit_Assert(node)

visit_Assign(node)

visit_Attribute(node)

visit_AugAssign(node)

visit_BinOp(node)

visit_BoolOp(node)

visit_Break(node)

visit_Bytes(node)

visit_Call(node)

visit_ClassDef(node)

visit_Compare(node)

visit_Continue(node)

visit_Delete(node)

visit_Dict(node)

visit_DictComp(node)

visit_Ellipsis(node)

visit_Expr(node)

visit_ExtSlice(node)

visit_For(node)

visit_FunctionDef(node)

visit_GeneratorExp(node)

visit_Global(node)

visit_If(node)

visit_IfExp(node)

visit_Import(node)

visit_ImportFrom(node)

visit_Lambda(node)

visit_List(node)

visit_ListComp(node)

visit_Name(node)

visit_Nonlocal(node)

visit_Num(node)

visit_Pass(node)

visit_Print(node)

visit_Raise(node)

visit_Repr(node)

visit_Return(node)

visit_Set(node)

visit_SetComp(node)

visit_Slice(node)

visit_Starred(node)

visit_Str(node)

visit_Subscript(node)

visit_TryExcept(node)

visit_TryFinally(node)

visit_Tuple(node)

visit_UnaryOp(node)

visit_While(node)

visit_With(node)

visit_Yield(node)

visit_alias(node)

visit_arguments(node)

visit_comprehension(node)

visit_excepthandler(node)

write(x)

core.codegen.to_source(node, indent_with=' ', add_line_information=False)

This function can convert a node tree back into python sourcecode. This is useful for debugging purposes, especially if you're dealing with custom asts not generated by python itself.

It could be that the sourcecode is evaluable when the AST itself is not compilable / evaluable. The reason for this is that the AST contains some more data than regular sourcecode does, which is dropped during conversion.

Each level of indentation is replaced with indent_with. Per default this parameter is equal to four spaces as suggested by PEP 8, but it might be adjusted to match the application's styleguide.

If add_line_information is set to True comments for the line numbers of the nodes are added to the output. This can be used to spot wrong line number information of statement nodes.