U
|
Þ=®dö ã @ s2 U d Z ddlZddlZddlZddlmZ ddlmZ ddl m
|
Z
|
ej r\ddl Z ddlmZ ejdd d
|
Zejejejejejejejd Zejeej ej ej gej f f e d < ej ej ej!d Z"ejeej ej gej f f e d< ej#ej$ej%ej&ej'ej(dd dd dZ)ejeej ej ej gej f f e d< G dd de*Z+G dd de,Z-G dd dZ.d ej/e. e.ddd Z0G d d d e-d Z1G d d d e1Z2G d!d" d"e1Z3G d#d$ d$e1Z4G d%d& d&e2Z5G d'd( d(e2Z6G d)d* d*e2Z7G d+d, d,e2Z8G d-d. d.e2Z9G d/d0 d0e2Z:G d1d2 d2e2Z;G d3d4 d4e2Z<G d5d6 d6e2Z=G d7d8 d8e2Z>G d9d: d:e2Z?G d;d< d<e2Z@G d=d> d>e2ZAG d?d@ d@e2ZBG dAdB dBe2ZCG dCdD dDe1ZDG dEdF dFeDZEG dGdH dHeDZFG dIdJ dJeDZGG dKdL dLeDZHG dMdN dNeDZIG dOdP dPeIZJG dQdR dReIZKG dSdT dTeIZLG dUdV dVeIZMG dWdX dXeIZG dYdZ dZe3ZNG d[d\ d\e3ZOG d]d^ d^eDZPejQd_ ej/e. ejLejMej ejej ej f f d`dadbZRG dcdd ddeDZSG dedf dfeSZTG dgdh dheSZUG didj djeDZVG dkdl dleDZWG dmdn dneDZXG dodp dpeDZYG dqdr dreDZZG dsdt dteDZ[G dudv dve3Z\G dwdx dxeEZ]G dydz dzeEZ^G d{d| d|eEZ_G d}d~ d~eEZ`G dd deEZaG dd deEZbG dd deEZcG d
d deEZdG dd deEZeG dd deFZfG dd deFZgG dd deFZhG dd deDZiG dd deDZjG dd deDZkG dd deDZlG dd deDZmG dd deDZnG dd deDZoG dd deDZpG dd d e2ZqG d¡d¢ d¢e2ZrG d£d¤ d¤e2ZsG d¥d¦ d¦e2ZtG d§d¨ d¨e2ZuG d©dª dªeuZvej ej d«d¬dd®Zwexewe-_y[wdS )¯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)Úbound)Ú*ú/ú//ú**ú%ú+ú-Ú_binop_to_func)Únotr r Ú _uaop_to_funcc C s | |kS ©N© ©ÚaÚbr r úCd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\jinja2/nodes.pyÚ<lambda>+ ó r c C s | |kS r r r r r r r , r )ÚeqÚneÚgtZgteqÚltZlteqÚinÚnotinÚ_cmpop_to_funcc @ 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 dD ]t}g }| t|r |d nt|d¡ | | |d¡¡ t|dksPtdt|tt|ksltdt|||< q| dd¡ t
|
| |||¡S ) N)ÚfieldsÚ
|
attributesr r r z multiple inheritance not allowedzlayout conflictÚabstractF) ÚextendÚgetattrÚobjectÚgetÚlenÚAssertionErrorÚsetÚtupleÚ
|
setdefaultÚtypeÚ__new__)ZmcsÚnameÚbasesÚdÚattrZstorager r r r7 9 s zNodeType.__new__N)r% r& r' r( r7 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 | |¡| _n|j| _d| _d S ©NF)r= ÚcallableÚ
|
autoescapeÚvolatile)Úselfr= r> r r r Ú__init__J s
|
|
zEvalContext.__init__©r? c C s
|
| j ¡ S r )Ú__dict__Úcopy©rD r r r ÚsaveT s zEvalContext.save)Úoldr? c C s | j ¡ | j |¡ d S r )rG ÚclearÚupdate)rD rK r r r ÚrevertW s
|
zEvalContext.revert)N) r% r& r' r( ÚtÚOptionalÚstrrE ÚMappingÚAnyrJ rN r r r r r< E s ÿ þ
|
r< )ÚnodeÚctxr? c C s( |d kr$| j d krtdt| j S |S )NzIif no eval context is passed, the node must have an attached environment.)r= Ú RuntimeErrorr< )rT rU r r r Úget_eval_context\ s
|
ÿ
|
rW c @ s e Zd ZU dZdZejedf ed< dZ ejedf ed< dZ
|
e ed< ej d ed
|
< ej ej d d d dZd+ej eje ej eje ejejeej f dddZd,ej eje ej eje ejd dddZeje ej e dddZejeje ejeje df f eje dddZed dddZd-e ed d d d Zd d d d!d"Zej ed#d$d%Z e j Z ed&d'd(Z ed&d)d*Z d S ).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.
|
r .r* ©Úlinenor= r+ TrY r r= N)r* r+ r? c O sÔ | j rtd|rt|t| jkrt| js>tt| jdtt| jdt| j dt| jdkrjdnd t| j|D ]\}}t| || q| jD ]}t| || |d ¡ q|rÐtdt
|
t |d S ) Nz#abstract nodes are not instantiablez takes 0 argumentsz takes 0 or z argumentr ÚsÚ zunknown attribute ) r, Ú TypeErrorr1 r* r6 r% ÚzipÚsetattrr+ ÚpopÚnextÚiter)rD r* r+ r8 Úargr; r r r rE s 0ÿ
|
z Node.__init__)ÚexcludeÚonlyr? c c sj | j D ]^}|dkr|dks:|dk r*||ks:|dk r||krz|t| |fV W q tk
|
rb Y qX qdS )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)rD rc rd r8 r r r Ú iter_fields s"
|
ÿÿþþýýzNode.iter_fieldsc c sP | ||¡D ]>\}}t|tr:|D ]}t|tr"|V q"q t|tr |V q 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)rf Ú
|
isinstanceÚlistr )rD rc rd Ú_ÚitemÚnr r r Úiter_child_nodes§ s
|
|
|
|
zNode.iter_child_nodes)Ú node_typer? c C s | |¡D ]
|
}| S dS )ziFind the first node of a given type. If no such node exists the
|
return value is `None`.
|
N)Úfind_all)rD rm Úresultr r r Úfind¸ s z Node.findc c s2 | ¡ D ]$}t||r |V | |¡E dH qdS )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)rl rg rn )rD rm Úchildr r r rn Á s
|
z Node.find_all)rU r? c C s: t | g}|r6| ¡ }d|jkr&||_| | ¡ ¡ q
|
| 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.
|
rU )r Úpopleftr* rU r- rl )rD rU ÚtodorT r r r Úset_ctxÌ s
|
|
z Node.set_ctxF)rY Úoverrider? c C sH t | g}|rD| ¡ }d|jkr4|jdks.|r4||_| | ¡ ¡ q
|
| S )z.Set the line numbers of the node and children.rY N)r rr r+ rY r- rl )rD rY ru rs rT r r r Ú
|
set_linenoÚ s
|
|
zNode.set_lineno)r= r? c C s0 t | g}|r,| ¡ }||_| | ¡ ¡ q
|
| S )z"Set the environment for all nodes.)r rr r= r- rl )rD r= rs rT r r r Úset_environmentå s
|
zNode.set_environment)Úotherr? c C s, t | t |k rtS t| ¡ t| ¡ kS r )r6 ÚNotImplementedr4 rf )rD rx r r r Ú__eq__î s z Node.__eq__rF c s0 d fdd jD ¡}t j d| dS )Nú, c 3 s$ | ] }| d t |dV qdS )ú=N)r. )Ú.0r rI r r Ú <genexpr>÷ s z Node.__repr__.<locals>.<genexpr>ú(ú))Újoinr* r6 r% )rD Úargs_strr rI r Ú__repr__ö s z Node.__repr__c s8 t jtt jf d d fdd g | d ¡S )N)rT r? c sÒ t | ts t| ¡ d S dt| j d¡ | jsH d¡ d S t| jD ]p\}}|rh d¡ t| |}t |t rº d¡ t|D ] \}}|r¤ d¡ | q d¡ qR | qR d¡ d S )Nznodes.r r r{ ú[ú])
|
rg r ÚappendÚreprr6 r% r* Ú enumerater. rh )rT ÚidxÚfieldÚvaluerj ©Ú_dumpÚbufr r r û s(
|
|
|
|
|
|
|
|
|
zNode.dump.<locals>._dumpr[ )rO ÚUnionr rS r rI r r r Údumpú s "z Node.dump)NN)NN)F)!r% r& r' r( r* rO ÚTuplerQ Ú__annotations__r+ r, ÚintrP rS rE Ú ContainerÚIteratorrf rl ÚTyper rp r rn rt Úboolrv rw rz r/ Ú__hash__r 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.TNr r r r r r s r c @ s$ e Zd ZU dZdZeje ed< dS )ÚTemplatezjNode that represents a template. This must be the outermost node that
|
is passed to the compiler.
|
©Úbodyr N© r% r& r' r( r* rO ÚListr r r r r r r $ s
|
r c @ s$ e Zd ZU dZdZejd ed< 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ÚExprr¤ N)r% r& r' r( r* rO r¡ r r r r r r¢ - s
|
r¢ c @ s e Zd ZU dZdZded< dS )ÚExtendsz Represents an extends statement.)Útemplater¥ r§ N)r% r& r' r( r* r r r r r r¦ 6 s
|
r¦ c @ sX e Zd ZU dZdZeed< eed< eje ed< eje ed< ej e ed< e
|
ed< d S )
|
Ú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`.
|
)Útargetra r Úelse_ÚtestÚ recursiver© ra r rª r« r¬ N) r% r& r' r( r* r r rO r¡ rP r r r r r r¨ = s
|
r¨ c @ sH e Zd ZU dZdZeed< eje ed< ejd ed< eje ed< dS )ÚIfz4If `test` is true, `body` is rendered, else `else_`.)r« r Úelif_rª r« r r® rª N) r% r& r' r( r* r r rO r¡ r r r r r O s
|
r c @ sH e Zd ZU dZdZeed< ejd ed< ejd ed< eje ed< d S )
|
Ú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.
|
)r8 ÚargsÚdefaultsr r8 ÚNamer° r¥ r± r N)
|
r% r& r' r( r* rQ r rO r¡ r r r r r r¯ Y s
|
r¯ c @ sH e Zd ZU dZdZded< ejd ed< ejd ed< eje ed < 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² r° r¥ r± r N) r% r& r' r( r* r rO r¡ r r r r r r³ f s
|
r³ c @ s, e Zd ZU dZdZeje ed< ded< dS )Ú FilterBlockzNode for filter sections.)r Úfilterr ÚFilterr· Nr r r r r r¶ r s
|
r¶ c @ s@ e Zd ZU dZdZejd ed< ejd ed< eje ed< 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¥ rº r» r N) r% r& r' r( r* rO r¡ r r r r r r r¹ z s
|
|
r¹ c @ s< e Zd ZU dZdZeed< eje ed< e
|
ed< e
|
ed< dS )ÚBlockzkA node that represents a block.
|
|
.. versionchanged:: 3.0.0
|
the `required` field was added.
|
)r8 r ÚscopedÚrequiredr8 r r½ r¾ N) r% r& r' r( r* rQ r rO r¡ r r r r r r r¼ s
|
r¼ c @ s. e Zd ZU dZdZded< eed< eed< dS )ÚIncludez'A node that represents the include tag.)r§ Ú with_contextÚignore_missingr¥ r§ rÀ rÁ N)r% r& r' r( r* r r r r r r r¿ s
|
|
r¿ c @ s. e Zd ZU dZdZded< eed< eed< dS )ÚImportz&A node that represents the import tag.)r§ r© rÀ r¥ r§ r© rÀ N)r% r& r' r( r* r rQ r r r r r r s
|
|
r c @ sH e Zd ZU dZdZded< ejeje ej
|
e e f f ed< e ed< 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¥ r§ rÄ rÀ N) r% r& r' r( r* r rO r¡ r rQ r r r r r r rà § s
|
|
"rà c @ s e Zd ZU dZdZeed< dS )ÚExprStmtzAA statement that evaluates an expression and discards the result.©rT rT N)r% r& r' r( r* r r r r r r rÅ ¹ s
|
rÅ c @ s& e Zd ZU dZdZded< eed< dS )ÚAssignz"Assigns an expression to a target.)r© rT r¥ r© rT N)r% r& r' r( r* r r r r r r rÇ À s
|
rÇ c @ s: e Zd ZU dZdZded< ejd ed< eje ed< dS ) Ú AssignBlockz Assigns a block to a target.)r© r· r r¥ r© r¸ r· r N)
|
r% r& r' r( r* r rO rP 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_ctxr? 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# ©rD rÊ r r r Úas_constÖ s z Expr.as_constrF c C s dS )z8Check if it's possible to assign something to this node.Fr rI r r r Ú
|
can_assignã s zExpr.can_assign)N) r% r& r' r( r, rO rP r< rS rÌ r rÍ r r r r r¥ Ñ s r¥ c @ sL e Zd ZU dZdZeed< eed< eed< dZd e j
|
e e j dd d
|
Z dS ) ÚBinExprz%Baseclass for all binary expressions.)ÚleftÚrightrÏ rÐ ÚoperatorTNrÉ c
|
C s| t | |}|jjr&| j|jjkr&t t| j }z || j |¡| j |¡W S t
|
k
|
rv } z t |W 5 d }~X Y nX d S r ) rW r= Ú sandboxedrÑ Zintercepted_binopsr# r rÏ rÌ rÐ Ú Exception©rD rÊ ÚfÚer r r rÌ ñ s
|
ÿ þ
|
zBinExpr.as_const)N©r% r& r' r( r* r¥ r rQ r, rO rP r< rS rÌ r r r r rÎ è s
|
rÎ c @ sD e Zd ZU dZdZeed< eed< dZd
|
e j
|
e e j ddd Z dS ) Ú UnaryExprz$Baseclass for all unary expressions.rÆ rT rÑ TNrÉ c
|
C sr t | |}|jjr&| j|jjkr&t t| j }z|| j |¡W S t k
|
rl } z t |W 5 d }~X Y nX d S r )
|
rW r= rÒ rÑ Zintercepted_unopsr# r rT rÌ rÓ rÔ r r r rÌ s
|
ÿ þ
|
zUnaryExpr.as_const)Nr× r r r r rØ s
|
rØ c @ s4 e Zd ZU dZdZeed< eed< edddZdS ) 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.
|
)r8 rU r8 rU rF c C s
|
| j dkS )N> ÚfalseÚTrueÚFalseÚnoneÚNoneÚtrue©r8 rI r r r rÍ & s zName.can_assignN© r% r& r' r( r* rQ r r rÍ r r r r r² s
|
|
r² c @ s4 e Zd ZU dZdZeed< eed< edddZdS ) ÚNSRefz)Reference to a namespace value assignment)r8 r; r8 r; rF c C s dS )NTr rI r r r rÍ 1 s zNSRef.can_assignNrà r r r r rá * s
|
|
rá c @ s e Zd ZdZdZdS )ÚLiteralzBaseclass for literals.TNr r r r r râ 9 s râ c @ s\ e Zd ZU dZdZejed< d eje ejdddZ
|
e d ejeje dd d d
|
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 r NrÉ c C s | j S r rä rË r r r rÌ I s zConst.as_constzt.Optional[Environment])r rY r= r? 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_reprrX )Úcompilerrå r# )Úclsr rY r= rå r r r Úfrom_untrustedL s zConst.from_untrusted)N)NN)r% r& r' r( r* rO rS r rP r< rÌ Ú classmethodr rè r r r r rã ? s
|
|
üûrã c @ s6 e Zd ZU dZdZeed< deje edddZ
|
dS ) Ú TemplateDatazA constant template string.)Údatarë NrÉ c C s, t | |}|jrt |jr&t| jS | jS r )rW rC r# rB r rë rË r r r rÌ d s
|
|
zTemplateData.as_const)N) r% r& r' r( r* rQ r rO rP r< rÌ r r r r rê ^ s
|
rê c @ s^ e Zd ZU dZdZeje ed< e ed< d ej
|
e ej ej df ddd Zed
|
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.
|
)ÚitemsrU rì rU N.rÉ c s" t | t fdd| jD S )Nc 3 s | ]}| ¡V qd S r ©rÌ ©r} Úx©rÊ r r r~ y s z!Tuple.as_const.<locals>.<genexpr>)rW r4 rì rË r rð r rÌ w s
|
zTuple.as_constrF c C s | j D ]}| ¡ s dS qdS )NFT)rì rÍ )rD rj r r r rÍ { s
|
zTuple.can_assign)N)r% r& r' r( r* rO r¡ r¥ r rQ rP r< r rS rÌ r rÍ r r r r r m s
|
$r c @ sD e Zd ZU dZdZeje ed< dej e
|
ejej dddZ dS ) r¡ z&Any list literal such as ``[1, 2, 3]``©rì rì NrÉ c s t | fdd| jD S )Nc s g | ]}| ¡qS r rí rî rð r r Ú
|
<listcomp> s z!List.as_const.<locals>.<listcomp>)rW rì rË r rð r rÌ s
|
z List.as_const)N) r% r& r' r( r* rO r¡ r¥ r rP r< rS rÌ r r r r r¡ s
|
r¡ c @ sJ e Zd ZU dZdZejd ed< 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ñ ÚPairrì NrÉ c s" t | t fdd| jD S )Nc 3 s | ]}| ¡V qd S r rí rî rð r r r~ s z Dict.as_const.<locals>.<genexpr>)rW Údictrì rË r rð r rÌ s
|
z Dict.as_const)N) r% r& r' r( r* rO r¡ r rP r< ró rS rÌ r r r r ró s
|
ÿþró c @ sL e Zd ZU dZdZeed< eed< d eje ej
|
ej ej f dddZ dS )
|
rô z A key, value pair for dicts.©Úkeyr r÷ r NrÉ c C s" t | |}| j |¡| j |¡fS r )rW r÷ rÌ r rË r r r rÌ £ s
|
z Pair.as_const)N) r% r& r' r( r* r¥ r rO rP r< r rS rÌ r r r r rô s
|
ÿþrô c @ sJ e Zd ZU dZdZeed< eed< d ej e
|
ej eej f dddZ dS )
|
ÚKeywordz>A key, value pair for keyword arguments where key is a string.rö r÷ r NrÉ c C s t | |}| j| j |¡fS r )rW r÷ r rÌ rË r r r rÌ ± s
|
zKeyword.as_const)N)r% r& r' r( r* rQ r r¥ rO rP r< r rS rÌ r r r r rø ª s
|
|
rø c @ sN e Zd ZU dZdZeed< eed< eje ed< d
|
eje ej
|
ddd Z dS ) ÚCondExprzZA conditional expression (inline if expression). (``{{
|
foo if bar else baz }}``)
|
)r« Úexpr1Úexpr2r« rú rû NrÉ c C s> t | |}| j |¡r"| j |¡S | jd kr2t | j |¡S r )rW r« rÌ rú rû r# rË r r r rÌ À s
|
|
zCondExpr.as_const)N) r% r& r' r( r* r¥ r rO rP r< rS rÌ r r r r rù ¶ s
|
rù )Ú_FilterTestCommonrµ )rT rÊ r? c
|
sÌ fdd| j D }t fdd| jD }| jd k rxz| | j ¡¡ W n* tk
|
rv } z t |W 5 d }~X Y nX | jd k rÄz| | j ¡¡ W n* tk
|
r } z t |W 5 d }~X Y nX ||fS )Nc s g | ]}| ¡qS r rí rî rð r r rò Ï s z!args_as_const.<locals>.<listcomp>c 3 s | ]}| ¡V qd S r rí rî rð r r r~ Ð s z args_as_const.<locals>.<genexpr>)
|
r° rõ ÚkwargsÚdyn_argsr- rÌ rÓ r# Ú
|
dyn_kwargsrM )rT rÊ r° rý rÖ r rð r Ú args_as_constÌ s
|
|
r c @ s| e Zd ZU dZeed< eed< eje ed< eje ed< ej
|
e ed< ej
|
e ed< dZ dZ d ej
|
e ejd
|
d d Zd S )rü )rT r8 r° rý rþ rÿ rT r8 r° rý rþ rÿ TNrÉ c
|
C s t | |}|jrt | jr&|jj}n|jj}| | j¡}t
|
|¡}|d ksV|t j kr\t |jj rt |dddks~t |¡rt t| |\}}| d| j |¡¡ |t jkr¾| d|¡ n|t jkrÖ| d|j¡ z |||W S tk
|
r } z t |W 5 d }~X Y nX d S )NZjinja_async_variantFTr )rW rC r# Ú
|
_is_filterr= ÚfiltersÚtestsr0 r8 r Zfrom_objÚcontextZis_asyncr. ÚinspectÚiscoroutinefunctionr ÚinsertrT rÌ Z eval_contextrÓ )rD rÊ Zenv_mapÚfuncZpass_argr° rý rÖ r r r rÌ ì s4
|
|
|
ÿþ
|
|
z_FilterTestCommon.as_const)N)r% r& r' r* r¥ r rQ rO r¡ rô rP r, r r< rS rÌ r r r r rü á s
|
rü c sB e Zd ZU dZeje ed< 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.
|
rT NrÉ c s | j d krt t j|dS )Nrð )rT r# ÚsuperrÌ rË ©Ú __class__r r rÌ s
|
zFilter.as_const)N) r% r& r' r( rO rP r¥ r r< rS 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 @ sV e Zd ZU dZdZeed< eje ed< eje ed< ej
|
e ed< ej
|
e ed< 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.
|
)rT r° rý rþ rÿ rT r° rý rþ rÿ N) r% r& r' r( r* r¥ r rO r¡ rø rP r r r r rµ / s
|
rµ c @ sH e Zd ZU dZdZeed< eed< eed< d
|
ej e
|
ej ddd Z dS ) ÚGetitemz@Get an attribute or item from an expression and prefer the item.)rT rb rU rT rb rU NrÉ c
|
C sj | j dkrt t| |}z |j | j |¡| j |¡¡W S tk
|
rd } z t |W 5 d }~X Y nX d S ©NÚload) rU r# rW r= ÚgetitemrT rÌ rb rÓ ©rD rÊ rÖ r r r rÌ G s
|
|
|
|
ÿzGetitem.as_const)N© r% r& r' r( r* r¥ r rQ rO rP r< rS rÌ r r r r r ? s
|
r c @ sH e Zd ZU dZdZeed< eed< eed< d
|
ej e
|
ej ddd Z dS ) ÚGetattrznGet an attribute or item from an expression that is a ascii-only
|
bytestring and prefer the attribute.
|
)rT r; rU rT r; rU NrÉ c
|
C sd | j dkrt t| |}z|j | j |¡| j¡W S tk
|
r^ } z t |W 5 d }~X Y nX d S r ) rU r# rW r= r. rT rÌ r; rÓ r r r r rÌ _ s
|
|
zGetattr.as_const)Nr r r r r r U s
|
r c @ sX e Zd ZU dZdZeje ed< eje ed< eje ed< d
|
eje e
|
ddd Z dS ) ÚSlicez_Represents a slice object. This must only be used as argument for
|
:class:`Subscript`.
|
)ÚstartÚstopÚstepr r r NrÉ c sJ t | tjt tjtj d fdd }t|| j|| j|| jS )N)Úobjr? c s | d kr d S | ¡S r rí )r rð r r Úconstx s z Slice.as_const.<locals>.const) rW rO rP r¥ rS Úslicer r r )rD rÊ r r rð r rÌ u s
|
"zSlice.as_const)N) r% r& r' r( r* rO rP r¥ r r< r rÌ r r r r r k s
|
r c @ s< e Zd ZU dZdZeje ed< dej e
|
e dddZ dS ) ÚConcatzXConcatenates the list of expressions provided after converting
|
them to strings.
|
r£ r¤ NrÉ c s$ t | d fdd| jD ¡S )Nr[ c 3 s | ]}t | ¡V qd S r )rQ rÌ rî rð r r r~ s z"Concat.as_const.<locals>.<genexpr>)rW r r¤ rË r rð r rÌ s
|
zConcat.as_const)N) r% r& r' r( r* rO r¡ r¥ r rP r< rQ rÌ r r r r r s
|
r c @ sF e Zd ZU dZdZeed< ejd ed< d
|
ej e
|
ej ddd Z dS ) ÚCompareziCompares an expression with some other expressions. `ops` must be a
|
list of :class:`Operand`\s.
|
)ÚexprÚopsr ÚOperandr NrÉ c
|
C s t | |}| j |¡ }}z<| jD ]0}|j |¡}t|j ||}|sN W dS |}q"W n* tk
|
r } z t |W 5 d }~X Y nX |S r@ )rW r rÌ r r" ÚoprÓ r# )rD rÊ ro r r! Ú new_valuerÖ r r r rÌ s
|
|
|
zCompare.as_const)N) r% r& r' r( r* r¥ r rO r¡ rP r< rS rÌ r r r r r s
|
|
r c @ s& e Zd ZU dZdZeed< eed< dS )r z$Holds an operator and an expression.)r! r r! r N)r% r& r' r( r* rQ 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 Nr$ 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.
|
r Nr$ r r r r r& ½ s r& c @ s e Zd ZdZdZdS )ÚAddz Add the left to the right node.r Nr$ r r r r r' Å s r' c @ s e Zd ZdZdZdS )ÚSubz&Subtract the right from the left node.r Nr$ r r r r r( Ë s r( c @ s e Zd ZdZdZdS )ÚModzLeft modulo right.r Nr$ r r r r r) Ñ s r) c @ s e Zd ZdZdZdS )ÚPowzLeft to the power of right.r Nr$ r r r r r* × s r* c @ s. e Zd ZdZdZdeje ejdddZ dS )ÚAndzShort circuited AND.ÚandNrÉ c C s" t | |}| j |¡o | j |¡S r ©rW rÏ rÌ rÐ rË r r r rÌ â s
|
z And.as_const)N©
|
r% r& r' r( rÑ rO rP r< rS rÌ r r r r r+ Ý s r+ c @ s. e Zd ZdZdZdeje ejdddZ dS )ÚOrzShort circuited OR.ÚorNrÉ c C s" t | |}| j |¡p | j |¡S r r- rË r r r rÌ ì s
|
z Or.as_const)Nr. r r r r r/ ç s r/ c @ s e Zd ZdZdZdS )ÚNotzNegate the expression.r Nr$ r r r r r1 ñ s r1 c @ s e Zd ZdZdZdS )ÚNegz Make the expression negative.r Nr$ r r r r r2 ÷ s r2 c @ s e Zd ZdZdZdS )ÚPosz8Make the expression positive (noop for most expressions)r Nr$ r r r r r3 ý s r3 c @ s e Zd ZU dZdZeed< dS )ÚEnvironmentAttributezLoads an attribute from the environment object. This is useful for
|
extensions that want to call a callback stored on the environment.
|
rß r8 N©r% r& r' r( r* rQ r r r r r r4 s
|
r4 c @ s& e Zd ZU dZdZeed< eed< dS )Ú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.
|
)Ú
|
identifierr8 r7 r8 Nr5 r r r r r6 s
|
r6 c @ s e Zd ZU dZdZeed< dS )Ú 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.
|
)Ú
|
importnamer9 Nr5 r r r r r8 s
|
r8 c @ s, e Zd ZU dZdZeed< ddddZdS )Ú 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ß r8 NrF c C s t dd S )NzKCan't create internal names. Use the `free_identifier` method on a parser.©r\ rI r r r rE 2 s ÿzInternalName.__init__)r% r& r' r( r* rQ r rE r r r r r: ' s
|
r: c @ s6 e Zd ZU dZdZeed< deje e
|
dddZ dS ) ÚMarkSafez:Mark the wrapped expression as safe (wrap it as `Markup`).©r r NrÉ c C s t | |}t| j |¡S r )rW r r rÌ rË r r r rÌ ? s
|
zMarkSafe.as_const)N) r% r& r' r( r* r¥ r rO rP r< r rÌ r r r r r< 9 s
|
r< c @ sB e Zd ZU dZdZeed< deje 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= r NrÉ c C s4 t | |}|jrt | j |¡}|jr0t|S |S r )rW rC r# r rÌ rB r )rD rÊ r r r r rÌ N s
|
z MarkSafeIfAutoescape.as_const)N)r% r& r' r( r* r¥ r rO rP r< r r rS 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.
|
Nr$ 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
|
Nr$ r r r r r@ l s r@ c @ s e Zd ZdZdS )ÚContinuezContinue a loop.Nr$ r r r r rA u s rA c @ s e Zd ZdZdS )ÚBreakz Break a loop.Nr$ r r r r rB y s rB c @ s$ e Zd ZU dZdZeje ed< dS )ÚScopezAn artificial scope.r r Nr r r r r rC } s
|
rC c @ s, e Zd ZU dZdZeed< eje ed< 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 r r N)
|
r% r& r' r( r* r¥ r rO r¡ r r r r r rD s
|
rD c @ s$ e Zd ZU dZdZeje ed< 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))])
|
)ÚoptionsrF N) r% r& r' r( r* rO r¡ rø r r r r r rE s
|
rE c @ s$ e Zd ZU dZdZeje ed< 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 r Nr r r r r rG ¤ s
|
rG z te.NoReturn)r° rý r? c O s t dd S )Nz can't create custom node typesr; )r° rý r r r Ú _failing_new¯ s rH )zr( r rÑ ÚtypingrO Ú collectionsr Z
|
markupsafer Úutilsr Ú TYPE_CHECKINGZtyping_extensionsÚter= r ÚTypeVarr ÚmulÚtruedivÚfloordivÚpowÚmodÚaddÚsubr ró rQ ÚCallablerS r Únot_ÚposÚnegr r r r Úger Úler" rÓ r# r6 r) r< rP rW 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/ r1 r2 r3 r4 r6 r8 r: r< r> r? r@ rA rB rC rD rE rG rH Ú staticmethodr7 r r r r Ú<module> sà ù, ý(ø, 2
|
"þ 0
|
|
|
|
