3
U'ícö ã @ s& U d Z ddlZddlZddlZddlmZ ddlmZ ddl m
Z
ej r\ddl Z
ddlmZ ejdd d
Zejejejejejejejd Zejeej ej ej gej f f ej ej ej d Z!ejeej ej gej f f !ej"ej#ej$ej%ej&ej'd
d dd dZ(ejeej ej ej gej f f (G dd de)Z*G dd de+Z,G dd dZ-d ej.e- e-dddZ/G dd d e,dZ0G d d d e0Z1G d d d e0Z2G d d! d!e0Z3G d"d# d#e1Z4G d$d% d%e1Z5G d&d' d'e1Z6G d(d) d)e1Z7G d*d+ d+e1Z8G d,d- d-e1Z9G d.d/ d/e1Z:G d0d1 d1e1Z;G d2d3 d3e1Z<G d4d5 d5e1Z=G d6d7 d7e1Z>G d8d9 d9e1Z?G d:d; d;e1Z@G d<d= d=e1ZAG d>d? d?e1ZBG d@dA dAe0ZCG dBdC dCeCZDG dDdE dEeCZEG dFdG dGeCZFG dHdI dIeCZGG dJdK dKeCZHG dLdM dMeHZIG dNdO dOeHZJG dPdQ dQeHZKG dRdS dSeHZLG dTdU dUeHZG dVdW dWe2ZMG dXdY dYe2ZNG dZd[ d[eCZOejPd« ej.e- ejKejLej ejej ej f f d^d_d`ZQG dad\ d\eCZRG dbdc dceRZSG ddde deeRZTG dfd] d]eCZUG dgdh dheCZVG didj djeCZWG dkdl dleCZXG dmdn dneCZYG dodp dpeCZZG dqdr dre2Z[G dsdt dteDZ\G dudv dveDZ]G dwdx dxeDZ^G dydz dzeDZ_G d{d| d|eDZ`G d}d~ d~eDZaG dd deDZbG dd deDZcG dd deDZdG d
d deEZeG dd deEZfG dd deEZgG dd deCZhG dd deCZiG dd deCZjG dd deCZkG dd deCZlG dd deCZmG dd deCZnG dd deCZoG dd de1ZpG dd de1ZqG dd d e1ZrG d¡d¢ d¢e1ZsG d£d¤ d¤e1ZtG d¥d¦ d¦etZuej ej d§d¨d©dªZveweve,_x[vdS )¬zAST nodes generated by the parser for the compiler. Also provides
some node tree helper functions used by the parser and compiler in order
to normalize nodes.
é N)Údeque)ÚMarkupé )Ú_PassArg)Ú EnvironmentÚ
_NodeBoundÚNode)Zbound)Ú*ú/z//z**ú%ú+ú-)Únotr r
c C s | |kS )N© )ÚaÚbr r ú./tmp/pip-build-gk9425m9/Jinja2/jinja2/nodes.pyÚ<lambda>+ s r c C s | |kS )Nr )r r r r r r , s )ÚeqÚneÚgtZgteqÚltZlteqÚinÚnotinc @ s e Zd ZdZdS )Ú
Impossiblez8Raised if the node could not perform a requested action.N)Ú__name__Ú
__module__Ú __qualname__Ú__doc__r r r r r 0 s r c @ s e Zd ZdZdd ZdS )ÚNodeTypez¦A 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 x|d D ]t}g }|j t|r |d nt|f |j |j|f t|dksRtdt|tt|ksntdt|||< qW |jdd t j
| |||S )
NÚfieldsÚ
attributesr r z multiple inheritance not allowedzlayout conflictÚabstractF)r r! ) ÚextendÚgetattrÚobjectÚgetÚlenÚAssertionErrorÚsetÚtupleÚ
setdefaultÚtypeÚ__new__)ZmcsÚnameÚbasesÚdÚattrZstorager r r r- 9 s
zNodeType.__new__N)r r r r r- r r r r r 4 s r c @ s` e Zd ZdZd
deje ddddZejeej f ddd Z
ejeej f dd
d d Z dS )Ú EvalContextzcHolds evaluation time information. Custom attributes can be attached
to it in extensions.
Nr )Ú environmentÚ
template_nameÚreturnc C s0 || _ t|jr |j|| _n|j| _d| _d S )NF)r3 ÚcallableÚ
autoescapeÚvolatile)Úselfr3 r4 r r r Ú__init__J s
zEvalContext.__init__)r5 c C s
| j j S )N)Ú__dict__Úcopy)r9 r r r ÚsaveT s zEvalContext.save)Úoldr5 c C s | j j | j j| d S )N)r; ÚclearÚupdate)r9 r> r r r ÚrevertW s
zEvalContext.revert)N) r r r r ÚtÚOptionalÚstrr: ÚMappingÚAnyr= rA r r r r r2 E s
r2 )ÚnodeÚctxr5 c C s( |d kr$| j d krtdt| j S |S )NzIif no eval context is passed, the node must have an attached environment.)r3 Ú RuntimeErrorr2 )rG rH r r r Úget_eval_context\ s
rJ c @ s e Zd ZU dZf Zejedf d'Zejedf dZ e
ej d
ejejddd d
Zd(ej eje ej eje ejejeejf d d d
Zd)ej eje ej eje ejd d ddZeje ej e dddZejeje ejeje df f eje dddZed dddZd*e
ed dddZdd d d d Z ejed d d!Z e j Z ed"d#d$Z ed"d%d&Z!dS )+r a» Baseclass for all Jinja 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.
.Úlinenor3 Tr N)r r! r5 c O sÜ | j rtd|rt|t| jkrt| js>tt| jdtt| jdt| j dt| jdkrjdnd x$t| j|D ]\}}t| || qW x"| jD ]}t| ||j |d q¢W |rØtdt
t |d S ) Nz#abstract nodes are not instantiablez takes 0 argumentsz takes 0 or z argumentr ÚsÚ zunknown attribute ) r" Ú TypeErrorr' r r, r ÚzipÚsetattrr! ÚpopÚnextÚiter)r9 r r! r. Úargr1 r r r r: s 4 z
Node.__init__)ÚexcludeÚonlyr5 c c sn xh| j D ]^}|dkr |dks<|dk r,||ks<|dk r||kry|t| |fV W q tk
rd 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)r9 rU rV r. 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 )zÞ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.
N)rX Ú
isinstanceÚlistr )r9 rU rV Ú_ÚitemÚnr r r Úiter_child_nodes§ s
zNode.iter_child_nodes)Ú node_typer5 c 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)r9 r_ Úresultr r r Úfind¸ s z Node.findc c s6 x0| j D ]$}t||r |V |j|E dH 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)r^ rY r` )r9 r_ Úchildr r r r` Á s
z
Node.find_all)rH r5 c 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.
rH )r Úpopleftr rH r# r^ )r9 rH ÚtodorG r r r Úset_ctxÌ s
z Node.set_ctxF)rK Úoverrider5 c 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.rK N)r rd r! rK r# r^ )r9 rK rg re rG r r r Ú
set_linenoÚ s
zNode.set_lineno)r3 r5 c C s4 t | g}x$|r.|j }||_|j|j q W | S )z"Set the environment for all nodes.)r rd r3 r# r^ )r9 r3 re rG r r r Úset_environmentå s
zNode.set_environment)Úotherr5 c C s, t | t |k rtS t| j t|j kS )N)r, ÚNotImplementedr* rX )r9 rj r r r Ú__eq__î s z Node.__eq__)r5 c s0 dj fdd jD }t j d| dS )Nz, c 3 s$ | ] }| d t |dV qdS )ú=N)r$ )Ú.0r )r9 r r ú <genexpr>÷ s z Node.__repr__.<locals>.<genexpr>ú(ú))Újoinr r, r )r9 Úargs_strr )r9 r Ú__repr__ö s z
Node.__repr__c s8 t jtt jf d d fdd g | djS )N)rG r5 c sÚ t | ts jt| d S jdt| j d | jsHjd d S xt| jD ]t\}}|rjjd t| |}t |t rÀjd x*t|D ] \}}|r¨jd | qW jd qT | qTW jd d S )Nznodes.rp rq z, ú[ú])
rY r ÚappendÚreprr, r r Ú enumerater$ rZ )rG ÚidxÚfieldÚvaluer\ )Ú_dumpÚbufr r r} û s(
zNode.dump.<locals>._dumprM )rB ÚUnionr rF rr )r9 r )r} r~ r Údumpú s "z Node.dump)rK r3 )NN)NN)F)"r r r r r rB ÚTuplerD r! r" ÚintrK rC r3 rF r: Ú ContainerÚIteratorrX r^ ÚTyper rb r r` rf Úboolrh ri rl r% Ú__hash__rt r r r r r r g s.
" )Ú metaclassc @ s e Zd ZdZdZdS )ÚStmtz Base node for all statements.TN)r r r r r" r r r r r s r c @ s e Zd ZdZdZdS )ÚHelperz,Nodes that exist in a specific context only.TN)r r r r r" r r r r r s r c @ s e Zd ZU dZdZeje dS )ÚTemplatezjNode that represents a template. This must be the outermost node that
is passed to the compiler.
ÚbodyN)r ) r r r r r rB ÚListr r r r r r r $ s
r c @ s e Zd ZU dZdZejd dS )ÚOutputzA node that holds multiple expressions which are then printed out.
This is used both for the `print` statement and the regular template data.
ÚnodesÚExprN)r )r r r r r rB r r r r r r r - s
r c @ s e Zd ZU dZdZddS )ÚExtendsz Represents an extends statement.Útemplater N)r )r r r r r r r r r r r 6 s
r c @ s@ e Zd ZU dZd Zeeej e
ej e ej e
edS )
Ú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`.
ÚtargetrS r Úelse_ÚtestÚ recursiveN)r rS r r r r )r r r r r r r rS rB r r r rC r r r r r r r r = s
r c @ s8 e Zd ZU dZdZeeje ejd
eje dS )ÚIfz4If `test` is true, `body` is rendered, else `else_`.r r Úelif_r N)r r r r ) r r r r r r r rB r r r r r r r r r O s
r c @ s8 e Zd ZU dZd Zeejd ejd
eje dS )
ÚMacrozÀA 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. ÚargsÚdefaultsr ÚNamer N)r. r r r )
r r r r r rD r. rB r r r r r r r r r r Y s
r c @ s8 e Zd ZU dZd
Zdejd ejd eje
d S ) Ú 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 r ÚCallr r N)r r r r ) r r r r r r rB r r r r r r r r r r f s
r c @ s$ e Zd ZU dZdZeje d dS )Ú FilterBlockzNode for filter sections.r ÚfilterÚFilterN)r r¢ )
r r r r r rB r r r r¢ r r r r r¡ r s
r¡ c @ s4 e Zd ZU dZdZejd ejd eje
dS )ÚWithz°Specific 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
ÚtargetsÚvaluesr r N)r¥ r¦ r ) r r r r r rB r r¥ r¦ r r r r r r r¤ z s
r¤ c @ s, e Zd ZU dZdZeeje
e e
dS )ÚBlockzkA node that represents a block.
.. versionchanged:: 3.0.0
the `required` field was added.
r. r ÚscopedÚrequiredN)r. r r¨ r© )r r r r r rD r. rB r r r r r¨ r© r r r r r§ s
r§ c @ s" e Zd ZU dZdZdeedS )ÚIncludez'A node that represents the include tag.r Ú with_contextÚignore_missingr N)r r« r¬ ) r r r r r r r r« r¬ r r r r rª s
rª c @ s" e Zd ZU dZdZdee dS )ÚImportz&A node that represents the import tag.r r r« r N)r r r« )
r r r r r r rD r r r« r r r r r s
r c @ s< e Zd ZU dZdZdejeje ej
e e f f e
dS )Ú
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« r N)r r¯ r« )r r r r r r rB r r rD r r¯ r r« r r r r r® § s
r® c @ s e Zd ZU dZdZedS )ÚExprStmtzAA statement that evaluates an expression and discards the result.rG N)rG )r r r r r r rG r r r r r° ¹ s
r° c @ s e Zd ZU dZdZdedS )ÚAssignz"Assigns an expression to a target.r rG r N)r rG )r r r r r r r rG r r r r r± À s
r± c @ s. e Zd ZU dZdZdejd ej e
dS ) Ú AssignBlockz Assigns a block to a target.r r¢ r r r£ N)r r¢ r ) r r r r r r rB rC r¢ r r r r r r r r² È s
r² c @ s< e Zd ZdZdZd
eje ejdddZ e
ddd Z dS ) r z Baseclass for all expressions.TN)Úeval_ctxr5 c 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 )r9 r³ r r r Úas_constÖ s z
Expr.as_const)r5 c C s dS )z8Check if it's possible to assign something to this node.Fr )r9 r r r Ú
can_assignã s zExpr.can_assign)N) r r r r r" rB rC r2 rF r´ r rµ r r r r r Ñ s
r c @ s@ e Zd ZU dZd Zeee dZ
d
e j e
e jdddZdS ) ÚBinExprz%Baseclass for all binary expressions.ÚleftÚrightTN)r³ r5 c C sz t | |}|jjr&| j|jjkr&t t| j }y|| jj|| j j|S t
k
rt } zt |W Y d d }~X nX d S )N) rJ r3 Ú sandboxedÚoperatorZintercepted_binopsr Ú_binop_to_funcr· r´ r¸ Ú Exception)r9 r³ ÚfÚer r r r´ ñ s
zBinExpr.as_const)r· r¸ )N)r r r r r r r· r¸ rD rº r" rB rC r2 rF r´ r r r r r¶ è s
r¶ c @ s< e Zd ZU dZdZeedZ d e
j e e
j
dddZdS )
Ú UnaryExprz$Baseclass for all unary expressions.rG TN)r³ r5 c C sp t | |}|jjr&| j|jjkr&t t| j }y|| jj|S t k
rj } zt |W Y d d }~X nX d S )N)
rJ r3 r¹ rº Zintercepted_unopsr Ú
_uaop_to_funcrG r´ r¼ )r9 r³ r½ r¾ r r r r´ s
zUnaryExpr.as_const)rG )N)r r r r r r rG rD rº r" rB rC r2 rF r´ r r r r r¿ s
r¿ c @ s, e Zd ZU dZdZeeedddZ dS ) r a 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. rH )r5 c C s
| j dkS )NÚtrueÚfalseÚnoneÚTrueÚFalseÚNone> r rÄ rÁ rà rÆ rÅ )r. )r9 r r r rµ & s zName.can_assignN)r. rH )
r r r r r rD r. rH r rµ r r r r r s
r c @ s, e Zd ZU dZdZeeedddZ dS ) ÚNSRefz)Reference to a namespace value assignmentr. r1 )r5 c C s dS )NTr )r9 r r r rµ 1 s zNSRef.can_assignN)r. r1 )
r r r r r rD r. r1 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È 9 s rÈ c @ sX e Zd ZU dZd Zejd eje ejdddZ
e d
ejeje dd dd d
Z
dS )Ú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).
r| N)r³ r5 c C s | j S )N)r| )r9 r³ r r r r´ I s zConst.as_constzt.Optional[Environment])r| rK r3 r5 c C s( ddl m} ||st | |||dS )z¨Return 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)rK r3 )ÚcompilerrÊ r )Úclsr| rK r3 rÊ r r r Úfrom_untrustedL s zConst.from_untrusted)r| )N)NN)r r r r r rB rF r| rC r2 r´ Ú classmethodr rÍ r r r r rÉ ? s
rÉ c @ s2 e Zd ZU dZdZedeje edddZ
dS ) Ú TemplateDatazA constant template string.ÚdataN)r³ r5 c C s, t | |}|jrt |jr&t| jS | jS )N)rJ r8 r r7 r rÐ )r9 r³ r r r r´ d s
zTemplateData.as_const)rÐ )N) r r r r r rD rÐ rB rC r2 r´ r r r r rÏ ^ s
rÏ c @ sV e Zd ZU dZd Zeje e
d
ej e ej
ejdf dddZed d
d ZdS )r z¼For 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.
ÚitemsrH N.)r³ r5 c s" t | t fdd| jD S )Nc 3 s | ]}|j V qd S )N)r´ )rn Úx)r³ r r ro y s z!Tuple.as_const.<locals>.<genexpr>)rJ r* rÑ )r9 r³ r )r³ r r´ w s
zTuple.as_const)r5 c C s x| j D ]}|j sdS qW dS )NFT)rÑ rµ )r9 r\ r r r rµ { s zTuple.can_assign)rÑ rH )N)r r r r r rB r r rÑ rD rH rC r2 r rF r´ r rµ r r r r r m s
$r c @ s@ e Zd ZU dZdZeje dej e
ejej dddZ dS ) r z&Any list literal such as ``[1, 2, 3]``rÑ N)r³ r5 c s t | fdd| jD S )Nc s g | ]}|j qS r )r´ )rn rÒ )r³ r r ú
<listcomp> s z!List.as_const.<locals>.<listcomp>)rJ rÑ )r9 r³ r )r³ r r´ s
z
List.as_const)rÑ )N)
r r r r r rB r r rÑ rC r2 rF r´ r r r r r s
r c @ sF e Zd ZU dZdZejd d eje ej
ej ej f dddZ dS )
ÚDictzeAny dict literal such as ``{1: 2, 3: 4}``. The items must be a list of
:class:`Pair` nodes.
rÑ ÚPairN)r³ r5 c s" t | t fdd| jD S )Nc 3 s | ]}|j V qd S )N)r´ )rn rÒ )r³ r r ro s z Dict.as_const.<locals>.<genexpr>)rJ ÚdictrÑ )r9 r³ r )r³ r r´ s
z
Dict.as_const)rÑ )N)
r r r r r rB r rÑ rC r2 rÔ rF r´ r r r r rÔ s
rÔ c @ sD e Zd ZU dZdZeed ej e
ej ej ej f dddZ
dS )
rÕ z A key, value pair for dicts.Úkeyr| N)r³ r5 c C s" t | |}| jj|| jj|fS )N)rJ r× r´ r| )r9 r³ r r r r´ £ s
z
Pair.as_const)r× r| )N)r r r r r r r× r| rB rC r2 r rF r´ r r r r rÕ s
rÕ c @ sB e Zd ZU dZdZeed e j
e e j ee j
f dddZdS )
ÚKeywordz>A key, value pair for keyword arguments where key is a string.r× r| N)r³ r5 c C s t | |}| j| jj|fS )N)rJ r× r| r´ )r9 r³ r r r r´ ± s
zKeyword.as_const)r× r| )N)r r r r r rD r× r r| rB rC r2 r rF r´ r r r r rØ ª s
rØ c @ sB e Zd ZU dZd Zeeej e
d
ej e ej dddZ
dS ) ÚCondExprzZA conditional expression (inline if expression). (``{{
foo if bar else baz }}``)
r Úexpr1Úexpr2N)r³ r5 c C s> t | |}| jj|r"| jj|S | jd kr2t | jj|S )N)rJ r r´ rÚ rÛ r )r9 r³ r r r r´ À s
zCondExpr.as_const)r rÚ rÛ )N)r r r r r r r rÚ rB rC rÛ r2 rF r´ r r r r rÙ ¶ s
rÙ Ú_FilterTestCommonr )rG r³ r5 c sÌ fdd| j D }t fdd| jD }| jd k rxy|j| jj W n* tk
rv } zt |W Y d d }~X nX | jd k rÄy|j | jj W n* tk
r } zt |W Y d d }~X nX ||fS )Nc s g | ]}|j qS r )r´ )rn rÒ )r³ r r rÓ Ï s z!args_as_const.<locals>.<listcomp>c 3 s | ]}|j V qd S )N)r´ )rn rÒ )r³ r r ro Ð s z args_as_const.<locals>.<genexpr>)
r rÖ ÚkwargsÚdyn_argsr# r´ r¼ r Ú
dyn_kwargsr@ )rG r³ r rÝ r¾ r )r³ r Ú
args_as_constÌ s
rà c @ sd e Zd ZU d Zeeej e
ej e ej
e ej
e dZdZd
ej
e ejd d
d ZdS )rÜ rG r. r rÝ rÞ rß TN)r³ r5 c C s t | |}|jrt | jr&|jj}n|jj}|j| j}t j
|}|d ksV|t j kr\t |jj rt
|dddks~tj|rt t| |\}}|jd| jj| |t jkr¾|jd| n|t jkrÖ|jd|j y
|||S tk
r } zt |W Y d d }~X nX d S )NZjinja_async_variantFTr )rJ r8 r Ú
_is_filterr3 ÚfiltersÚtestsr& r. r Zfrom_objÚcontextZis_asyncr$ ÚinspectÚiscoroutinefunctionrà ÚinsertrG r´ Z eval_contextr¼ )r9 r³ Zenv_mapÚfuncZpass_argr rÝ r¾ r r r r´ ì s0
z_FilterTestCommon.as_const)rG r. r rÝ rÞ rß )N)r r r r r rG rD r. rB r r rÕ rÝ rC rÞ rß r" rá r2 rF r´ r r r r rÜ á s
c s> e Zd ZU dZeje deje ej d fdd
Z
Z S )r£ zöApply a filter to an expression. ``name`` is the name of the
filter, the other fields are the same as :class:`Call`.
If ``node`` is ``None``, the filter is being used in a filter block
and is applied to the content of the block.
N)r³ r5 c s | j d krt t j|dS )N)r³ )rG r Úsuperr´ )r9 r³ )Ú __class__r r r´ s
zFilter.as_const)N) r r r r rB rC r rG r2 rF r´ Ú
__classcell__r r )rê r r£ s
r£ c @ s e Zd ZdZdZdS )ÚTesta/ Apply a test to an expression. ``name`` is the name of the test,
the other field are the same as :class:`Call`.
.. versionchanged:: 3.0
``as_const`` shares the same logic for filters and tests. Tests
check for volatile, async, and ``@pass_context`` etc.
decorators.
FN)r r r r rá r r r r rì " s rì c @ sB e Zd ZU dZdZeeje eje
ej e
ej e dS ) r a/ 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.
rG r rÝ rÞ rß N)rG r rÝ rÞ rß )r r r r r r rG rB r r rØ rÝ rC rÞ rß r r r r r / s
c @ s< e Zd ZU dZd Zeee d
e
j e e
j
dddZdS ) ÚGetitemz@Get an attribute or item from an expression and prefer the item.rG rT rH N)r³ r5 c C sh | j dkrt t| |}y |jj| jj|| jj|S tk
rb } zt |W Y d d }~X nX d S )NÚload) rH r rJ r3 ÚgetitemrG r´ rT r¼ )r9 r³ r¾ r r r r´ G s
zGetitem.as_const)rG rT rH )N)r r r r r r rG rT rD rH rB rC r2 rF r´ r r r r rí ? s
rí c @ s< e Zd ZU dZd Zeee d
e
j e e
j
dddZdS ) ÚGetattrznGet an attribute or item from an expression that is a ascii-only
bytestring and prefer the attribute.
rG r1 rH N)r³ r5 c C sb | j dkrt t| |}y|jj| jj|| jS tk
r\ } zt |W Y d d }~X nX d S )Nrî ) rH r rJ r3 r$ rG r´ r1 r¼ )r9 r³ r¾ r r r r´ _ s
zGetattr.as_const)rG r1 rH )N)r r r r r r rG rD r1 rH rB rC r2 rF r´ r r r r rð U s
rð c @ sL e Zd ZU dZd Zeje eje eje
d
eje e dddZ
dS ) ÚSlicez_Represents a slice object. This must only be used as argument for
:class:`Subscript`.
ÚstartÚstopÚstepN)r³ r5 c sJ t | tjt tjtj d fdd }t|| j|| j|| jS )N)Úobjr5 c s | d kr d S | j S )N)r´ )rõ )r³ r r Úconstx s z Slice.as_const.<locals>.const) rJ rB rC r rF Úslicerò ró rô )r9 r³ rö r )r³ r r´ u s
"zSlice.as_const)rò ró rô )N)r r r r r rB rC r rò ró rô r2 r÷ r´ r r r r rñ k s
rñ c @ s8 e Zd ZU dZdZeje dej e
e dddZ dS ) ÚConcatzXConcatenates the list of expressions provided after converting
them to strings.
r N)r³ r5 c s$ t | dj fdd| jD S )NrM c 3 s | ]}t |j V qd S )N)rD r´ )rn rÒ )r³ r r ro s z"Concat.as_const.<locals>.<genexpr>)rJ rr r )r9 r³ r )r³ r r´ s
zConcat.as_const)r )N)
r r r r r rB r r r rC r2 rD r´ r r r r rø s
rø c @ s> e Zd ZU dZd Zeejd d
ej
e ej dddZ
dS ) ÚCompareziCompares an expression with some other expressions. `ops` must be a
list of :class:`Operand`\s.
ÚexprÚopsÚOperandN)r³ r5 c C s t | |}| jj| }}y<x6| jD ],}|jj|}t|j ||}|sLdS |}q$W W n* tk
r } zt |W Y d d }~X nX |S )NF)rJ rú r´ rû Ú_cmpop_to_funcÚopr¼ r )r9 r³ ra r| rþ Z new_valuer¾ r r r r´ s
zCompare.as_const)rú rû )N)r r r r r r rú rB r rû rC r2 rF r´ r r r r rù s
rù c @ s e Zd ZU dZdZeedS )rü z$Holds an operator and an expression.rþ rú N)rþ rú ) r r r r r rD rþ r rú r r r r rü © s
rü 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 )ÚFloorDivzbDivides the left by the right node and converts 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 Ë s r c @ s e Zd ZdZdZdS )ÚModzLeft modulo right.r N)r r r r rº r r r r r Ñ 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 ZdZdZdeje ejdddZ dS )ÚAndzShort circuited AND.ÚandN)r³ r5 c C s" t | |}| jj|o | jj|S )N)rJ r· r´ r¸ )r9 r³ r r r r´ â s
z And.as_const)N)
r r r r rº rB rC r2 rF r´ r r r r r Ý s r c @ s. e Zd ZdZdZdeje ejdddZ dS )ÚOrzShort circuited OR.ÚorN)r³ r5 c C s" t | |}| jj|p | jj|S )N)rJ r· r´ r¸ )r9 r³ r r r r´ ì s
z Or.as_const)N)
r r r r rº rB rC r2 rF r´ r r r r r ç s r c @ s e Zd ZdZdZdS )ÚNotzNegate the expression.r N)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 ÷ 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 ZU dZdZedS )Ú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 rD r. r r r r r
s
r
c @ s e Zd ZU dZdZeedS )ÚExtensionAttributezøReturns 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 rD r r. r r r r r s
r c @ s e Zd ZU dZdZedS )Ú 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 rD r r r r r r s
r c @ s( e Zd ZU dZdZeddddZdS )Ú InternalNamea6 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 treated specially by the compiler.
r. N)r5 c C s t dd S )NzKCan't create internal names. Use the `free_identifier` method on a parser.)rN )r9 r r r r: 2 s zInternalName.__init__)r. )r r r r r rD r. r: r r r r r ' s
r c @ s2 e Zd ZU dZdZedeje e
dddZ dS ) ÚMarkSafez:Mark the wrapped expression as safe (wrap it as `Markup`).rú N)r³ r5 c C s t | |}t| jj|S )N)rJ r rú r´ )r9 r³ r r r r´ ? s
zMarkSafe.as_const)rú )N) r r r r r r rú rB rC r2 r r´ r r r r r 9 s
r c @ s> e Zd ZU dZdZedeje ej
e ej f dddZ
dS ) ÚMarkSafeIfAutoescapezMark the wrapped expression as safe (wrap it as `Markup`) but
only if autoescaping is active.
.. versionadded:: 2.5
rú N)r³ r5 c C s4 t | |}|jrt | jj|}|jr0t|S |S )N)rJ r8 r rú r´ r7 r )r9 r³ rú r r r r´ N s
z MarkSafeIfAutoescape.as_const)rú )N)r r r r r r rú rB rC r2 r r rF r´ r r r r r D s
r c @ s e Zd ZdZdS )ÚContextReferenceaM 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'))
This is basically equivalent to using the
:func:`~jinja2.pass_context` decorator when using the high-level
API, which causes a reference to the context to be passed as the
first argument to a function.
N)r r r r r r r r r Z s r c @ s e Zd ZdZdS )ÚDerivedContextReferencezÉReturn the current template context including locals. Behaves
exactly like :class:`ContextReference`, but includes local
variables, such as from a ``for`` loop.
.. versionadded:: 2.11
N)r r r r r r r r r l s r c @ s e Zd ZdZdS )ÚContinuezContinue a loop.N)r r r r r r r r r u s r c @ s e Zd ZdZdS )ÚBreakz
Break a loop.N)r r r r r r r r r y s r c @ s e Zd ZU dZdZeje dS )ÚScopezAn artificial scope.r N)r ) r r r r r rB r r r r r r r r } s
r c @ s$ e Zd ZU dZdZeeje
dS )Ú 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
rä r N)rä r ) r r r r r r rä rB r r r r r r r r s
r c @ s e Zd ZU dZdZeje dS )Ú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 rB r rØ r r r r r r s
r c @ s e Zd ZU dZdZeje dS )ÚScopedEvalContextModifierzÈModifies 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`.
r N)r ) r r r r r rB r r r r r r r r ¤ s
r z te.NoReturn)r rÝ r5 c O s t dd S )Nz can't create custom node types)rN )r rÝ r r r Ú _failing_new¯ s r )rÜ r )yr rå rº ÚtypingrB Ú collectionsr Z
markupsafer Úutilsr Z
TYPE_CHECKINGZtyping_extensionsÚter3 r ZTypeVarr ÚmulÚtruedivÚfloordivÚpowÚmodÚaddÚsubr» rÔ rD ÚCallablerF Únot_ÚposÚnegrÀ r r r Úger Úlerý r¼ r r, r r2 rC rJ 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 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 Ú staticmethodr- r r r r Ú<module> sÖ ,(. 2
.0