class documentation

class Node:

Known subclasses: jinja2.nodes.Expr, jinja2.nodes.Helper, jinja2.nodes.Stmt, jinja2.nodes.Template

View In Hierarchy

Baseclass for all Jinja nodes. There are a number of nodes available of different types. There are four major types:

All nodes have fields and attributes. Fields may be other nodes, lists, or arbitrary values. Fields are passed to the constructor as regular positional arguments, attributes as keyword arguments. Each node has two attributes: lineno (the line number of the node) and environment. The environment attribute is set at the end of the parsing process for all nodes automatically.

Method find Find the first node of a given type. If no such node exists the return value is None.
Method find​_all Find all the nodes of a given type. If the type is a tuple, the check is performed for any of the tuple items.
Method iter​_child​_nodes Iterates over all direct child nodes of the node. This iterates over all fields and yields the values of they are nodes. If the value of a field is a list all the nodes in that list are returned.
Method iter​_fields No summary
Method set​_ctx No summary
Method set​_environment Set the environment for all nodes.
Method set​_lineno Set the line numbers of the node and children.
Method __eq__ Undocumented
Method __init__ Undocumented
Method __repr__ Undocumented
Method dump Undocumented
Class Variable abstract Undocumented
Class Variable attributes Undocumented
Class Variable environment Undocumented
Class Variable fields Undocumented
Class Variable lineno Undocumented
def find(self, node_type):
Find the first node of a given type. If no such node exists the return value is None.
Parameters
node​_type:t.Type[_NodeBound]Undocumented
Returns
t.Optional[_NodeBound]Undocumented
def find_all(self, node_type):
Find all the nodes of a given type. If the type is a tuple, the check is performed for any of the tuple items.
Parameters
node​_type:t.Union[t.Type[_NodeBound], t.Tuple[t.Type[_NodeBound], ...]]Undocumented
Returns
t.Iterator[_NodeBound]Undocumented
def iter_child_nodes(self, exclude=None, only=None):
Iterates over all direct child nodes of the node. This iterates over all fields and yields the values of they are nodes. If the value of a field is a list all the nodes in that list are returned.
Parameters
exclude:t.Optional[t.Container[str]]Undocumented
only:t.Optional[t.Container[str]]Undocumented
Returns
t.Iterator[Node]Undocumented
def iter_fields(self, exclude=None, only=None):
This method iterates over all fields that are defined and yields (key, value) tuples. Per default all fields are returned, but it's possible to limit that to some fields by providing the only parameter or to exclude some using the exclude parameter. Both should be sets or tuples of field names.
Parameters
exclude:t.Optional[t.Container[str]]Undocumented
only:t.Optional[t.Container[str]]Undocumented
Returns
t.Iterator[t.Tuple[str, t.Any]]Undocumented
def set_ctx(self, ctx):
Reset the context of a node and all child nodes. Per default the parser will all generate nodes that have a 'load' context as it's the most common one. This method is used in the parser to set assignment targets and other nodes to a store context.
Parameters
ctx:strUndocumented
Returns
NodeUndocumented
def set_environment(self, environment):
Set the environment for all nodes.
Parameters
environment:EnvironmentUndocumented
Returns
NodeUndocumented
def set_lineno(self, lineno, override=False):
Set the line numbers of the node and children.
Parameters
lineno:intUndocumented
override:boolUndocumented
Returns
NodeUndocumented
def __eq__(self, other):

Undocumented

Parameters
other:t.AnyUndocumented
Returns
boolUndocumented
def __init__(self, *fields, **attributes):

Undocumented

Parameters
*fields:t.AnyUndocumented
**attributes:t.AnyUndocumented
def __repr__(self):

Undocumented

Returns
strUndocumented
def dump(self):

Undocumented

Returns
strUndocumented
abstract: bool =
attributes: t.Tuple[str, ...] =

Undocumented

environment: t.Optional[Environment] =

Undocumented

lineno: int =

Undocumented