3
sݨ\x @ sv d Z ddlZddlZddlmZ ddlmZ ddlmZm Z m
Z
m Z ej ej
fZejejejejejejejdZejejejdZejej ej ej ej ej dd d
d d Z!G d d
d
e"Z#G dd de$Z%G dd de&Z'dd Z(G dd de e%e&Z)G dd de)Z*G dd de)Z+G dd de)Z,G d d d e*Z-G d d d e*Z.G d d! d!e*Z/G d"d# d#e*Z0G d$d% d%e*Z1G d&d' d'e*Z2G d(d) d)e*Z3G d*d+ d+e*Z4G d,d- d-e*Z5G d.d/ d/e*Z6G d0d1 d1e*Z7G d2d3 d3e*Z8G d4d5 d5e*Z9G d6d7 d7e*Z:G d8d9 d9e*Z;G d:d; d;e)Zd? d?e<Z>G d@dA dAe<Z?G dBdC dCe<Z@G dDdE dEe<ZAG dFdG dGeAZBG dHdI dIeAZCG dJdK dKeAZDG dLdM dMeAZEG dNdO dOeAZFG dPdQ dQe+ZGG dRdS dSe+ZHG dTdU dUe<ZIdVdW ZJG dXdY dYe<ZKG dZd[ d[e<ZLG d\d] d]e<ZMG d^d_ d_e<ZNG d`da dae<ZOG dbdc dce<ZPG ddde dee<ZQG dfdg dge<ZRG dhdi die+ZSeS j djdkjTeUdldm eVeeVeB eVe!B D 7 _ G dndo doe=ZWG dpdq dqe=ZXG drds dse=ZYG dtdu due=ZZG dvdw dwe=Z[G dxdy dye=Z\G dzd{ d{e=Z]G d|d} d}e=Z^G d~d de=Z_G dd de>Z`G dd de>ZaG dd de>ZbG dd de<ZcG dd de<ZdG dd de<ZeG dd de<ZfG dd de<ZgG dd de<ZhG dd de<ZiG dd de*ZjG dd de*ZkG dd de*ZlG dd de*ZmG dd de*ZnG dd denZodd Zpeqepe%_r[pdS )a}
jinja2.nodes
~~~~~~~~~~~~
This module implements additional nodes derived from the ast base node.
It also provides some node tree helper functions like `in_lineno` and
`get_nodes` used by the parser and translator in order to normalize
python and jinja nodes.
:copyright: (c) 2017 by the Jinja Team.
:license: BSD, see LICENSE for more details.
N)deque)Markup)izipwith_metaclass text_typePY2)*/z//z**%+-)notr r c C s | |kS )N )abr r /usr/lib/python3.6/nodes.py2 s r c C s | |kS )Nr )r r r r r r 3 s )eqnegtZgteqltZlteqinZnotinc @ s e Zd ZdZdS )
Impossiblez8Raised if the node could not perform a requested action.N)__name__
__module__ __qualname____doc__r r r r r 7 s r c @ s e Zd ZdZdd ZdS )NodeTypezA metaclass for nodes that handles the field and attribute
inheritance. fields and attributes from the parent class are
automatically forwarded to the child.c C s xtd D ]l}g }|j t|d |f |j |j|f t|dksJtdt|tt|ksftdt|||< qW |jdd tj | |||S )
Nfields
attributesr z multiple inheritance not allowedzlayout conflictabstractF)r r )
extendgetattrgetlenAssertionErrorsettuple
setdefaulttype__new__)clsnamebasesdattrZstorager r r r+ @ s
zNodeType.__new__N)r r r r r+ r r r r r ; s r c @ s* e Zd ZdZd ddZdd Zdd ZdS )
EvalContextzcHolds evaluation time information. Custom attributes can be attached
to it in extensions.
Nc C s0 || _ t|jr |j|| _n|j| _d| _d S )NF) environmentcallable
autoescapevolatile)selfr2 Z
template_namer r r __init__Q s
zEvalContext.__init__c C s
| j j S )N)__dict__copy)r6 r r r saveY s zEvalContext.savec C s | j j | j j| d S )N)r8 clearupdate)r6 oldr r r revert\ s
zEvalContext.revert)N)r r r r r7 r: r> r r r r r1 L s
r1 c C s( |d kr$| j d krtdt| j S |S )NzIif no eval context is passed, the node must have an attached environment.)r2 RuntimeErrorr1 )nodectxr r r get_eval_contexta s
rB c @ s e Zd ZdZf Zd ZdZdd Zd dd Zd!d
d Z d d
Z
dd Z dd Z d"ddZ
dd Zdd Zdd ZejZdd Zd d ZdS )#Nodea Baseclass for all Jinja2 nodes. There are a number of nodes available
of different types. There are four major types:
- :class:`Stmt`: statements
- :class:`Expr`: expressions
- :class:`Helper`: helper nodes
- :class:`Template`: the outermost wrapper node
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.
linenor2 Tc O s | j rtd|rt|t| jkrh| js:td| jj td| jjt| jt| jdkr^dp`df x$t| j|D ]\}}t| || qvW x"| jD ]}t| ||j |d qW |rtdt
t | d S )Nz#abstract nodes are not instanciablez%r takes 0 argumentsz%r takes 0 or %d argument%sr s zunknown attribute %r) r! TypeErrorr% r __class__r r setattrr popnextiter)r6 r r r- argr0 r r r r7 s$ z
Node.__init__Nc c sv xp| j D ]f}|| ko dkn sD|dk r4||ksD|dk r||kry|t| |fV W q tk
rl Y qX qW dS )aZ 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.
N)r r# AttributeError)r6 excludeonlyr- r r r iter_fields s zNode.iter_fieldsc c sX xR| j ||D ]B\}}t|tr@x.|D ]}t|tr&|V q&W qt|tr|V qW dS )zIterates 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.
N)rQ
isinstancelistrC )r6 rO rP fielditemnr r r iter_child_nodes s
zNode.iter_child_nodesc C s x| j |D ]}|S W dS )ziFind the first node of a given type. If no such node exists the
return value is `None`.
N)find_all)r6 node_typeresultr r r find s z Node.findc c s@ x:| j D ].}t||r |V x|j|D ]
}|V q*W q
W dS )zFind all the nodes of a given type. If the type is a tuple,
the check is performed for any of the tuple items.
N)rW rR rX )r6 rY ZchildrZ r r r rX s
z
Node.find_allc C s> t | g}x.|r8|j }d|jkr(||_|j|j q W | S )a 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.
rA )r popleftr rA r" rW )r6 rA todor@ r r r set_ctx s
z Node.set_ctxFc C sL t | g}x<|rF|j }d|jkr6|jdks0|r6||_|j|j q W | S )z.Set the line numbers of the node and children.rD N)r r\ r rD r" rW )r6 rD overrider] r@ r r r
set_lineno s
zNode.set_linenoc C s4 t | g}x$|r.|j }||_|j|j q W | S )z"Set the environment for all nodes.)r r\ r2 r" rW )r6 r2 r] r@ r r r set_environment s
zNode.set_environmentc C s( t | t |ko&t| j t|j kS )N)r* r( rQ )r6 otherr r r __eq__ s z Node.__eq__c C s | j | S )N)rc )r6 rb r r r __ne__ s z Node.__ne__c s& d j jdj fdd jD f S )Nz%s(%s)z, c 3 s" | ]}d |t |df V qdS )z%s=%rN)r# ).0rM )r6 r r s z Node.__repr__..)rH r joinr )r6 r )r6 r __repr__ s z
Node.__repr__c s$ fdd g | dj S )Nc s t | ts jt| d S jd| jj | jsBjd d S xt| jD ]t\}}|rdjd t| |}t |t rjd x*t|D ] \}}|rjd | qW jd qN | qNW jd d S )Nz nodes.%s()z, [])
rR rC appendreprrH r r enumerater# rS )r@ idxrT valuerU )_dumpbufr r rq s(
zNode.dump.._dumprF )rg )r6 r )rq rr r dump s z Node.dump)rD r2 )NN)NN)F)r r r r r r r! r7 rQ rW r[ rX r^ r` ra rc rd object__hash__rh rs r r r r rC k s"
rC c @ s e Zd ZdZdZdS )Stmtz Base node for all statements.TN)r r r r r! r r r r rv s rv c @ s e Zd ZdZdZdS )Helperz,Nodes that exist in a specific context only.TN)r r r r r! r r r r rw s rw c @ s e Zd ZdZdZdS )TemplatezjNode that represents a template. This must be the outermost node that
is passed to the compiler.
bodyN)ry )r r r r r r r r r rx s rx c @ s e Zd ZdZdZdS )OutputzA node that holds multiple expressions which are then printed out.
This is used both for the `print` statement and the regular template data.
nodesN)r{ )r r r r r r r r r rz $ s rz c @ s e Zd ZdZdZdS )Extendsz Represents an extends statement.templateN)r} )r r r r r r r r r r| + s r| c @ s e Zd ZdZd ZdS )
Forax The for loop. `target` is the target for the iteration (usually a
:class:`Name` or :class:`Tuple`), `iter` the iterable. `body` is a list
of nodes that are used as loop-body, and `else_` a list of nodes for the
`else` block. If no else node exists it has to be an empty list.
For filtered nodes an expression can be stored as `test`, otherwise `None`.
targetrL ry else_test recursiveN)r rL ry r r r )r r r r r r r r r r~ 0 s r~ c @ s e Zd ZdZdZdS )Ifz4If `test` is true, `body` is rendered, else `else_`.r ry elif_r N)r ry r r )r r r r r r r r r r ; s r c @ s e Zd ZdZdZdS )MacrozA macro definition. `name` is the name of the macro, `args` a list of
arguments and `defaults` a list of defaults if there are any. `body` is
a list of nodes for the macro body.
r- argsdefaultsry N)r- r r ry )r r r r r r r r r r @ s r c @ s e Zd ZdZdZdS ) CallBlockzLike a macro without a name but a call instead. `call` is called with
the unnamed macro as `caller` argument this node holds.
callr r ry N)r r r ry )r r r r r r r r r r H s r c @ s e Zd ZdZdZdS ) FilterBlockzNode for filter sections.ry filterN)ry r )r r r r r r r r r r O s r c @ s e Zd ZdZdZdS )WithzSpecific node for with statements. In older versions of Jinja the
with statement was implemented on the base of the `Scope` node instead.
.. versionadded:: 2.9.3
targetsvaluesry N)r r ry )r r r r r r r r r r T s r c @ s e Zd ZdZdZdS )Blockz A node that represents a block.r- ry scopedN)r- ry r )r r r r r r r r r r ] s r c @ s e Zd ZdZdZdS )Includez'A node that represents the include tag.r} with_contextignore_missingN)r} r r )r r r r r r r r r r b s r c @ s e Zd ZdZdZdS )Importz&A node that represents the import tag.r} r r N)r} r r )r r r r r r r r r r g s r c @ s e Zd ZdZdZdS )
FromImporta A node that represents the from import tag. It's important to not
pass unsafe names to the name attribute. The compiler translates the
attribute lookups directly into getattr calls and does *not* use the
subscript callback of the interface. As exported variables may not
start with double underscores (which the parser asserts) this is not a
problem for regular Jinja code, but if this node is used in an extension
extra care must be taken.
The list of names may contain tuples if aliases are wanted.
r} namesr N)r} r r )r r r r r r r r r r l s
r c @ s e Zd ZdZdZdS )ExprStmtzAA statement that evaluates an expression and discards the result.r@ N)r@ )r r r r r r r r r r z s r c @ s e Zd ZdZdZdS )Assignz"Assigns an expression to a target.r r@ N)r r@ )r r r r r r r r r r s r c @ s e Zd ZdZdZdS ) AssignBlockz Assigns a block to a target.r r ry N)r r ry )r r r r r r r r r r s r c @ s& e Zd ZdZdZdddZdd ZdS ) Exprz Baseclass for all expressions.TNc C s
t dS )an Return the value of the expression as constant or raise
:exc:`Impossible` if this was not possible.
An :class:`EvalContext` can be provided, if none is given
a default context is created which requires the nodes to have
an attached environment.
.. versionchanged:: 2.4
the `eval_ctx` parameter was added.
N)r )r6 eval_ctxr r r as_const s z
Expr.as_constc C s dS )z8Check if it's possible to assign something to this node.Fr )r6 r r r
can_assign s zExpr.can_assign)N)r r r r r! r r r r r r r s
r c @ s& e Zd ZdZdZdZdZd ddZdS )
BinExprz%Baseclass for all binary expressions.leftrightNTc C sj t | |}| jjr&| j| jjkr&t t| j }y|| jj|| j j|S t
k
rd t Y nX d S )N) rB r2 sandboxedoperatorZintercepted_binopsr _binop_to_funcr r r Exception)r6 r fr r r r s
zBinExpr.as_const)r r )N)r r r r r r r! r r r r r r s
r c @ s& e Zd ZdZdZdZdZdddZdS ) UnaryExprz$Baseclass for all unary expressions.r@ NTc C s` t | |}| jjr&| j| jjkr&t t| j }y|| jj|S t k
rZ t Y nX d S )N)
rB r2 r r Zintercepted_unopsr
_uaop_to_funcr@ r r )r6 r r r r r r s
zUnaryExpr.as_const)r@ )N)r r r r r r r! r r r r r r s
r c @ s e Zd ZdZdZdd ZdS )Namea Looks up a name or stores a value in a name.
The `ctx` of the node can be one of the following values:
- `store`: store a value in the name
- `load`: load that name
- `param`: like `store` but if the name was defined as function parameter.
r- rA c C s
| j dkS )NtruefalsenoneTrueFalseNone)r r r r r r )r- )r6 r r r r s zName.can_assignN)r- rA )r r r r r r r r r r r s r c @ s e Zd ZdZdZdd ZdS )NSRefz)Reference to a namespace value assignmentr- r0 c C s dS )NTr )r6 r r r r s zNSRef.can_assignN)r- r0 )r r r r r r r r r r r s r c @ s e Zd ZdZdZdS )LiteralzBaseclass for literals.TN)r r r r r! r r r r r s r c @ s, e Zd ZdZdZd ddZed
ddZdS ) Consta All constant values. The parser will return this node for simple
constants such as ``42`` or ``"foo"`` but it can be used to store more
complex values such as lists too. Only constants with a safe
representation (objects where ``eval(repr(x)) == x`` is true).
rp Nc C sJ | j }trFt|tkrF| jjd rFy|jd}W n tk
rD Y nX |S )Nzcompiler.ascii_strascii)rp r r* r r2 Zpoliciesencode UnicodeError)r6 r rvr r r r s zConst.as_constc C s( ddl m} ||st | |||dS )zReturn a const object if the value is representable as
constant value in the generated code, otherwise it will raise
an `Impossible` exception.
r )
has_safe_repr)rD r2 )Zcompilerr r )r, rp rD r2 r r r r from_untrusted s zConst.from_untrusted)rp )N)NN)r r r r r r classmethodr r r r r r s
r c @ s e Zd ZdZdZdddZdS ) TemplateDatazA constant template string.dataNc C s, t | |}|jrt |jr&t| jS | jS )N)rB r5 r r4 r r )r6 r r r r r s
zTemplateData.as_const)r )N)r r r r r r r r r r r s r c @ s& e Zd ZdZd Zd
ddZdd ZdS ) TuplezFor loop unpacking and some other things like multiple arguments
for subscripts. Like for :class:`Name` `ctx` specifies if the tuple
is used for loading the names or storing.
itemsrA Nc s" t | t fdd| jD S )Nc 3 s | ]}|j V qd S )N)r )re x)r r r rf s z!Tuple.as_const..)rB r( r )r6 r r )r r r s
zTuple.as_constc C s x| j D ]}|j sdS qW dS )NFT)r r )r6 rU r r r r s zTuple.can_assign)r rA )N)r r r r r r r r r r r r s
r c @ s e Zd ZdZdZdddZdS )Listz&Any list literal such as ``[1, 2, 3]``r Nc s t | fdd| jD S )Nc s g | ]}|j qS r )r )re r )r r r
( s z!List.as_const..)rB r )r6 r r )r r r & s
z
List.as_const)r )N)r r r r r r r r r r r " s r c @ s e Zd ZdZdZdddZdS )DictzeAny dict literal such as ``{1: 2, 3: 4}``. The items must be a list of
:class:`Pair` nodes.
r Nc s" t | t fdd| jD S )Nc 3 s | ]}|j V qd S )N)r )re r )r r r rf 3 s z Dict.as_const..)rB dictr )r6 r r )r r r 1 s
z
Dict.as_const)r )N)r r r r r r r r r r r + s r c @ s e Zd ZdZdZdddZdS ) Pairz A key, value pair for dicts.keyrp Nc C s" t | |}| jj|| jj|fS )N)rB r r rp )r6 r r r r r : s
z
Pair.as_const)r rp )N)r r r r r r r r r r r 6 s r c @ s e Zd ZdZdZdddZdS ) Keywordz>A key, value pair for keyword arguments where key is a string.r rp Nc C s t | |}| j| jj|fS )N)rB r rp r )r6 r r r r r C s
zKeyword.as_const)r rp )N)r r r r r r r r r r r ? s r c @ s e Zd ZdZdZd ddZdS )
CondExprzZA conditional expression (inline if expression). (``{{
foo if bar else baz }}``)
r expr1expr2Nc C s> t | |}| jj|r"| jj|S | jd kr2t | jj|S )N)rB r r r r r )r6 r r r r r N s
zCondExpr.as_const)r r r )N)r r r r r r r r r r r H s r c s fdd| j D }t fdd| jD }| jd k rhy|j| jj W n tk
rf t Y nX | jd k ry|j | jj W n tk
r t Y nX ||fS )Nc s g | ]}|j qS r )r )re r )r r r r [ s z!args_as_const..c 3 s | ]}|j V qd S )N)r )re r )r r r rf \ s z args_as_const..)
r r kwargsdyn_argsr" r r r
dyn_kwargsr< )r@ r r r r )r r
args_as_constZ s
r c @ s e Zd ZdZd Zd d d
ZdS )
Filtera This node applies a filter on an expression. `name` is the name of
the filter, the rest of the fields are the same as for :class:`Call`.
If the `node` of a filter is `None` the contents of the last buffer are
filtered. Buffers are created by macros and filter blocks.
r@ r- r r r r Nc C s t | |}|js| jd kr t | jjj| j}|d ksDt|ddrJt |jj rdt|ddrdt t
| |\}}|j d| jj | t|ddr|j d| nt|ddr|j d| j y
|||S t
k
r t Y nX d S )NZ
contextfilterFZasyncfiltervariantr ZevalcontextfilterZenvironmentfilter)rB r5 r@ r r2 filtersr$ r- r# Zis_asyncr insertr r )r6 r Zfilter_r r r r r r w s&
zFilter.as_const)r@ r- r r r r )N)r r r r r r r r r r r m s r c @ s e Zd ZdZd Zd d d
ZdS )
TestzApplies a test on an expression. `name` is the name of the test, the
rest of the fields are the same as for :class:`Call`.
r@ r- r r r r Nc C st | j jj| j}|d kr t t| |}t| |\}}|jd| jj | y
|||S t
k
rn t Y nX d S )Nr ) r2 Ztestsr$ r- r rB r r r@ r r )r6 r r r r r r r r s
z
Test.as_const)r@ r- r r r r )N)r r r r r r r r r r r s r c @ s e Zd ZdZdZdS ) Calla/ Calls an expression. `args` is a list of arguments, `kwargs` a list
of keyword arguments (list of :class:`Keyword` nodes), and `dyn_args`
and `dyn_kwargs` has to be either `None` or a node that is used as
node for dynamic positional (``*args``) or keyword (``**kwargs``)
arguments.
r@ r r r r N)r@ r r r r )r r r r r r r r r r s r c @ s& e Zd ZdZd
Zd ddZdd ZdS ) Getitemz@Get an attribute or item from an expression and prefer the item.r@ rM rA Nc C sX t | |}| jdkrt y | jj| jj|| jj|S tk
rR t Y nX d S )Nload) rB rA r r2 getitemr@ r rM r )r6 r r r r r s
zGetitem.as_constc C s dS )NFr )r6 r r r r s zGetitem.can_assign)r@ rM rA )N)r r r r r r r r r r r r s
r c @ s& e Zd ZdZd
Zd ddZdd ZdS ) GetattrznGet an attribute or item from an expression that is a ascii-only
bytestring and prefer the attribute.
r@ r0 rA Nc C sR | j dkrt y"t| |}| jj| jj|| jS tk
rL t Y nX d S )Nr ) rA r rB r2 r# r@ r r0 r )r6 r r r r r s
zGetattr.as_constc C s dS )NFr )r6 r r r r s zGetattr.can_assign)r@ r0 rA )N)r r r r r r r r r r r r s
r c @ s e Zd ZdZdZd ddZdS )
Slicez_Represents a slice object. This must only be used as argument for
:class:`Subscript`.
startstopstepNc s4 t | fdd}t|| j|| j|| jS )Nc s | d kr d S | j S )N)r )obj)r r r const s z Slice.as_const..const)rB slicer r r )r6 r r r )r r r s
zSlice.as_const)r r r )N)r r r r r r r r r r r s r c @ s e Zd ZdZdZdddZdS )ConcatzXConcatenates the list of expressions provided after converting them to
unicode.
r{ Nc s$ t | dj fdd| jD S )NrF c 3 s | ]}t |j V qd S )N)r r )re r )r r r rf s z"Concat.as_const..)rB rg r{ )r6 r r )r r r s
zConcat.as_const)r{ )N)r r r r r r r r r r r s r c @ s e Zd ZdZdZdddZdS ) CompareziCompares an expression with some other expressions. `ops` must be a
list of :class:`Operand`\s.
expropsNc C sn t | |}| jj| }}y4x.| jD ]$}|jj|}t|j ||}|}q$W W n tk
rh t Y nX |S )N)rB r r r _cmpop_to_funcopr r )r6 r rZ rp r Z new_valuer r r r s
zCompare.as_const)r r )N)r r r r r r r r r r r s r c @ s e Zd ZdZdZdS )Operandz$Holds an operator and an expression.r r N)r r )r r r r r r r r r r s r z(
The following operators are available: z, c c s | ]}d | V qdS )z``%s``Nr )re r r r r rf s rf c @ s e Zd ZdZdZdS )Mulz(Multiplies the left with the right node.r N)r r r r r r r r r r s r c @ s e Zd ZdZdZdS )Divz#Divides the left by the right node.r N)r r r r r r r r r r s r c @ s e Zd ZdZdZdS )FloorDivzjDivides the left by the right node and truncates conver the
result into an integer by truncating.
z//N)r r r r r r r r r r % s r c @ s e Zd ZdZdZdS )Addz Add the left to the right node.r N)r r r r r r r r r r , s r c @ s e Zd ZdZdZdS )Subz&Subtract the right from the left node.r N)r r r r r r r r r r 1 s r c @ s e Zd ZdZdZdS )ModzLeft modulo right.r
N)r r r r r r r r r r 6 s r c @ s e Zd ZdZdZdS )PowzLeft to the power of right.z**N)r r r r r r r r r r ; s r c @ s e Zd ZdZdZdddZdS )AndzShort circuited AND.andNc C s" t | |}| jj|o | jj|S )N)rB r r r )r6 r r r r r D s
z And.as_const)N)r r r r r r r r r r r @ s r c @ s e Zd ZdZdZdddZdS )OrzShort circuited OR.orNc C s" t | |}| jj|p | jj|S )N)rB r r r )r6 r r r r r M s
z Or.as_const)N)r r r r r r r r r r r I s r c @ s e Zd ZdZdZdS )NotzNegate the expression.r
N)r r r r r r r r r r R s r c @ s e Zd ZdZdZdS )Negz Make the expression negative.r N)r r r r r r r r r r W s r c @ s e Zd ZdZdZdS )Posz8Make the expression positive (noop for most expressions)r N)r r r r r r r r r r \ s r c @ s e Zd ZdZdZdS )EnvironmentAttributezLoads an attribute from the environment object. This is useful for
extensions that want to call a callback stored on the environment.
r- N)r- )r r r r r r r r r r d s r c @ s e Zd ZdZdZdS )ExtensionAttributezReturns the attribute of an extension bound to the environment.
The identifier is the identifier of the :class:`Extension`.
This node is usually constructed by calling the
:meth:`~jinja2.ext.Extension.attr` method on an extension.
identifierr- N)r r- )r r r r r r r r r r k s r c @ s e Zd ZdZdZdS ) ImportedNamea& If created with an import name the import name is returned on node
access. For example ``ImportedName('cgi.escape')`` returns the `escape`
function from the cgi module on evaluation. Imports are optimized by the
compiler so there is no need to assign them to local variables.
importnameN)r )r r r r r r r r r r u s r c @ s e Zd ZdZdZdd ZdS ) InternalNamea7 An internal name in the compiler. You cannot create these nodes
yourself but the parser provides a
:meth:`~jinja2.parser.Parser.free_identifier` method that creates
a new identifier for you. This identifier is not available from the
template and is not threated specially by the compiler.
r- c C s t dd S )NzKCan't create internal names. Use the `free_identifier` method on a parser.)rG )r6 r r r r7 s zInternalName.__init__N)r- )r r r r r r7 r r r r r ~ s r c @ s e Zd ZdZdZdddZdS )MarkSafez:Mark the wrapped expression as safe (wrap it as `Markup`).r Nc C s t | |}t| jj|S )N)rB r r r )r6 r r r r r s
zMarkSafe.as_const)r )N)r r r r r r r r r r r s r c @ s e Zd ZdZdZdddZdS )MarkSafeIfAutoescapezMark the wrapped expression as safe (wrap it as `Markup`) but
only if autoescaping is active.
.. versionadded:: 2.5
r Nc C s4 t | |}|jrt | jj|}|jr0t|S |S )N)rB r5 r r r r4 r )r6 r r r r r r s
z MarkSafeIfAutoescape.as_const)r )N)r r r r r r r r r r r s r c @ s e Zd ZdZdS )ContextReferencear Returns the current template context. It can be used like a
:class:`Name` node, with a ``'load'`` ctx and will return the
current :class:`~jinja2.runtime.Context` object.
Here an example that assigns the current template name to a
variable named `foo`::
Assign(Name('foo', ctx='store'),
Getattr(ContextReference(), 'name'))
N)r r r r r r r r r s
r c @ s e Zd ZdZdS )ContinuezContinue a loop.N)r r r r r r r r r s r c @ s e Zd ZdZdS )Breakz
Break a loop.N)r r r r r r r r r s r c @ s e Zd ZdZdZdS )ScopezAn artificial scope.ry N)ry )r r r r r r r r r r s r c @ s e Zd ZdZdZdS ) OverlayScopea An overlay scope for extensions. This is a largely unoptimized scope
that however can be used to introduce completely arbitrary variables into
a sub scope from a dictionary or dictionary like object. The `context`
field has to evaluate to a dictionary object.
Example usage::
OverlayScope(context=self.call_method('get_context'),
body=[...])
.. versionadded:: 2.10
contextry N)r ry )r r r r r r r r r r s r c @ s e Zd ZdZdZdS )EvalContextModifiera
Modifies the eval context. For each option that should be modified,
a :class:`Keyword` has to be added to the :attr:`options` list.
Example to change the `autoescape` setting::
EvalContextModifier(options=[Keyword('autoescape', Const(True))])
optionsN)r )r r r r r r r r r r s r c @ s e Zd ZdZdZdS )ScopedEvalContextModifierzModifies the eval context and reverts it later. Works exactly like
:class:`EvalContextModifier` but will only modify the
:class:`~jinja2.nodes.EvalContext` for nodes in the :attr:`body`.
ry N)ry )r r r r r r r r r r s r c O s t dd S )Nz can't create custom node types)rG )r r r r r _failing_new s r )sr typesr collectionsr Z jinja2.utilsr Zjinja2._compatr r r r FunctionType
MethodTypeZ_context_function_typesmultruedivfloordivpowmodaddsubr not_posnegr r r r ger ler r r r* r rt r1 rB rC rv rw rx rz r| r~ r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r r rg sortedr' r r r r r r r r r r r r r r r r r r r r r r r r r r staticmethodr+ r r r r s
)
0
&