spack.util.unparse package

spack.util.unparse.unparse(tree, py_ver_consistent=False)

Submodules

spack.util.unparse.unparser module

Usage: unparse.py <path to source file>

class spack.util.unparse.unparser.NodeVisitor

Bases: object

A node visitor base class that walks the abstract syntax tree and calls a visitor function for every node found. This function may return a value which is forwarded by the visit method.

This class is meant to be subclassed, with the subclass adding visitor methods.

Per default the visitor functions for the nodes are 'visit_' + class name of the node. So a TryFinally node visit function would be visit_TryFinally. This behavior can be changed by overriding the visit method. If no visitor function exists for a node (return value None) the generic_visit visitor is used instead.

Don’t use the NodeVisitor if you want to apply changes to nodes during traversing. For this a special visitor exists (NodeTransformer) that allows modifications.

generic_visit(node)

Called if no explicit visitor function exists for a node.

visit(node)

Visit a node.

class spack.util.unparse.unparser.Unparser(py_ver_consistent=False, _avoid_backslashes=False)

Bases: NodeVisitor

Methods in this class recursively traverse an AST and output source code for the abstract syntax; original formatting is disregarded.

binop

binop_precedence

binop_rassoc

block(*, extra=None)

A context manager for preparing the source for blocks. It adds the character’:’, increases the indentation on enter and decreases the indentation on exit. If extra is given, it will be directly appended after the colon character.

boolop_precedence

boolops

buffered(buffer=None)

cmpops

delimit(start, end)

A context manager for preparing the source for expressions. It adds start to the buffer and enters, after exit it adds end.

delimit_if(start, end, condition)

do_visit_try(node)

fill(text='')

Indent a piece of text and append it, according to the current indentation level

get_precedence(node)

get_raw_docstring(node)

If a docstring node is found in the body of the node parameter, return that docstring node, None otherwise.

Logic mirrored from _PyAST_GetDocString.

get_type_comment(node)

interleave(inter, f, seq)

Call f on each item in seq, calling inter() in between.

items_view(traverser, items)

Traverse and separate the given items with a comma and append it to the buffer. If items is a single item sequence, a trailing comma will be added.

maybe_newline()

Adds a newline if it isn’t the start of generated source

require_parens(precedence, node)

Shortcut to adding precedence related parens

set_precedence(precedence, *nodes)

traverse(node)

unop

unop_precedence

visit(node)

Outputs a source code string that, if converted back to an ast (using ast.parse) will generate an AST equivalent to node

visit_AnnAssign(node)

visit_Assert(node)

visit_Assign(node)

visit_AsyncFor(node)

visit_AsyncFunctionDef(node)

visit_AsyncWith(node)

visit_Attribute(node: Attribute)

visit_AugAssign(node)

visit_Await(node)

visit_BinOp(node)

visit_BoolOp(node)

visit_Break(node)

visit_Call(node)

visit_ClassDef(node)

visit_Compare(node)

visit_Constant(node)

visit_Continue(node)

visit_Delete(node)

visit_Dict(node)

visit_DictComp(node)

visit_ExceptHandler(node)

visit_Expr(node)

visit_ExtSlice(node)

visit_For(node)

visit_FormattedValue(node)

visit_FunctionDef(node)

visit_FunctionType(node)

visit_GeneratorExp(node)

visit_Global(node)

visit_If(node)

visit_IfExp(node)

visit_Import(node)

visit_ImportFrom(node)

visit_Index(node)

visit_Interpolation(node)

visit_JoinedStr(node)

visit_Lambda(node)

visit_List(node)

visit_ListComp(node)

visit_Match(node)

visit_MatchAs(node)

visit_MatchClass(node)

visit_MatchMapping(node)

visit_MatchOr(node)

visit_MatchSequence(node)

visit_MatchSingleton(node)

visit_MatchStar(node)

visit_MatchValue(node)

visit_Module(node)

visit_Name(node)

visit_NamedExpr(node)

visit_Nonlocal(node)

visit_ParamSpec(node)

visit_Pass(node)

visit_Raise(node)

visit_Return(node)

visit_Set(node)

visit_SetComp(node)

visit_Slice(node)

visit_Starred(node)

visit_Subscript(node)

visit_TemplateStr(node)

visit_Try(node)

visit_TryStar(node)

visit_Tuple(node)

visit_TypeAlias(node)

visit_TypeVar(node)

visit_TypeVarTuple(node)

visit_UnaryOp(node)

visit_While(node)

visit_With(node)

visit_Yield(node)

visit_YieldFrom(node)

visit_alias(node)

visit_arg(node)

visit_arguments(node)

visit_comprehension(node)

visit_keyword(node)

visit_match_case(node)

visit_withitem(node)

write(*text)

Add new source parts

spack.util.unparse.unparser.is_non_empty_non_star_tuple(slice_value)

True for (1, 2), False for () and (1, *b)

spack.util.unparse.unparser.iter_fields(node)

Yield a tuple of (fieldname, value) for each field in node._fields that is present on node.

spack.util.unparse.unparser.nullcontext()