w:iQQddZddlmZddlmZddlmZmZmZm Z ddl m Z ddl m Z mZmZddlmZddlmZdd lmZmZmZmZmZmZmZgd Zd ZGd d eZGddeZ GddeZ!eZ"GddeZ#GddeZ$GddeZ%Gdde%Z&Gdde%Z'd(dZ( d)d Z)d!Z*ej+,Z-e-.e e$d"e/gd#Z0Gd$d%e Z1Gd&d'e1Z2dS)*z4Support for "safe" evaluation of Python expressions.)dedent)CodeType)builtinsexec_ string_types text_type)Markup)ASTTransformerASTCodeGeneratorparse)TemplateRuntimeError)flatten)ast _ast_Constantget_code_paramsbuild_code_chunkisstring IS_PYTHON2_ast_Str)Code ExpressionSuite LenientLookup StrictLookup UndefinedUndefinedErrorzrestructuredtext encJeZdZdZgdZ d dZdZdZd Zd Z d Z d Z dS)rz=Abstract base class for the `Expression` and `Suite` classes.)sourcecoder_globalsNstrictc t|tr||_t||j}not|t js Jd|zd|_|jdkrt j}||_nt j }|g|_||_ t||j|j||||_ |t}n*t|trttd|}|j|_dS)aCreate the code object, either from a string, or from an AST node. :param source: either a string containing the source code, or an AST node :param filename: the (preferably absolute) name of the file containing the code :param lineno: the number of the line on which the code was found :param lookup: the lookup class that defines how variables are looked up in the context; can be either "strict" (the default), "lenient", or a custom lookup class :param xform: the AST transformer that should be applied to the code; if `None`, the appropriate transformation is chosen depending on the mode )modez'Expected string or AST node, but got %r?eval)r$filenamelinenoxformN)lenientr") isinstancerr_parser$_astASTrbodyModuler_compilerrrglobalsr )selfrr'r(lookupr)nodes L/var/www/html/trac/venv/lib/python3.11/site-packages/genshi/template/eval.py__init__z Code.__init__&s fl + + % DK&ty111DDfdh// C C9FB C C CDKyF""((" {}}#H T4;TY&.vULLL >"FF  - - P!.,GGOF ct|jdr |jj}n |jj}|j|j|d}t |j|d<|S)N__self__)rrr4r)hasattrr r:im_selfrrrr)r3 lookup_fnstates r6 __getstate__zCode.__getstate__MsW 4=* - - . .II -I;tx9MM' 22f  r8c|d|_|d|_tdg|dR|_|dj|_dS)Nrrrrr4)rrrrr2r )r3r>s r6 __setstate__zCode.__setstate__WsEHo <Q/v/// h/ r8cbt|t|ko|j|jkSN)typerr3others r6__eq__z Code.__eq__]s'U tDzz)H UZ0GHr8c*t|jSrC)hashrr3s r6__hash__z Code.__hash__`sDIr8c||k SrCrEs r6__ne__z Code.__ne__cs5=  r8c@t|jd|jdS)N())rD__name__rrJs r6__repr__z Code.__repr__fs"::... <>> data = dict(test='Foo', items=[1, 2, 3], dict={'some': 'thing'}) >>> Expression('test').evaluate(data) 'Foo' >>> Expression('items[0]').evaluate(data) 1 >>> Expression('items[-1]').evaluate(data) 3 >>> Expression('dict["some"]').evaluate(data) 'thing' Similar to e.g. Javascript, expressions in templates can use the dot notation for attribute access to access items in mappings: >>> Expression('dict.some').evaluate(data) 'thing' This also works the other way around: item access can be used to access any object attribute: >>> class MyClass(object): ... myattr = 'Bar' >>> data = dict(mine=MyClass(), key='myattr') >>> Expression('mine.myattr').evaluate(data) 'Bar' >>> Expression('mine["myattr"]').evaluate(data) 'Bar' >>> Expression('mine[key]').evaluate(data) 'Bar' All of the standard Python operators are available to template expressions. Built-in functions such as ``len()`` are also available in template expressions: >>> data = dict(items=[1, 2, 3]) >>> Expression('len(items)').evaluate(data) 3 r&c`d}||}t|j|d|iS)zEvaluate the expression against the given data dictionary. :param data: a mapping containing the data to evaluate against :return: the result of the evaluation before_and_this__data__)r r&rr3data__traceback_hide__r s r6evaluatezExpression.evaluates4 /==&&DIx*d);<<>> data = dict(test='Foo', items=[1, 2, 3], dict={'some': 'thing'}) >>> Suite("foo = dict['some']").execute(data) >>> data['foo'] 'thing' execc`d}||}t|j||dS)zExecute the suite in the given data dictionary. :param data: a mapping containing the data to execute in rZN)r rrr\s r6executez Suite.executes5 /==&& di4(((((r8N)rRrTrUrVrWr$rcrMr8r6rrs9I D)))))r8rceZdZdZefdZdS)rzException thrown when a template expression attempts to access a variable not defined in the context. :see: `LenientLookup`, `StrictLookup` cx|turt|d|d}nd|z}tj||dS)Nz has no member named ""z"%s" not defined) UNDEFINEDreprr r7)r3nameownermessages r6r7zUndefinedError.__init__sJ  ! !7;E{{{{DDDIGG(4/G%dG44444r8N)rRrTrUrVrgr7rMr8r6rrs7 $-555555r8rcVeZdZdZddgZefdZdZdZeZ dZ dZ d Z e xZ xZZd Zd S) raRepresents a reference to an undefined variable. Unlike the Python runtime, template expressions can refer to an undefined variable without causing a `NameError` to be raised. The result will be an instance of the `Undefined` class, which is treated the same as ``False`` in conditions, but raise an exception on any other operation: >>> foo = Undefined('foo') >>> bool(foo) False >>> list(foo) [] >>> print(foo) undefined However, calling an undefined variable, or trying to access an attribute of that variable, will raise an exception that includes the name used to reference that undefined variable. >>> try: ... foo('bar') ... except UndefinedError as e: ... print(e.msg) "foo" not defined >>> try: ... foo.bar ... except UndefinedError as e: ... print(e.msg) "foo" not defined :see: `LenientLookup` _name_ownerc"||_||_dS)zInitialize the object. :param name: the name of the reference :param owner: the owning object, if the variable is accessed as a member N)rmrn)r3rirjs r6r7zUndefined.__init__s   r8c tgSrC)iterrJs r6__iter__zUndefined.__iter__s Bxxr8cdS)NFrMrJs r6__bool__zUndefined.__bool__sur8cBdt|jd|jdS)N< >)rDrRrmrJs r6rSzUndefined.__repr__s$ JJ///<d}t|dkr|d} ||S#ttttf$rX}t |t r=t||t}|tur| ||}|cYd}~Sd}~wwxYw)NTrr) lenrr IndexErrorrr+rrrgrz)rrrr^ers r6rzLookupBase.lookup_item6s! s88q==a&C s8O*i@   #|,, c3 22)##--3-77C   s"'BA BBBBct)zCan be overridden by subclasses to specify behavior when undefined variables are accessed. :param key: the name of the variable :param owner: the owning object, if the variable is accessed as a member )NotImplementedError)rrrjs r6rzzLookupBase.undefinedEs "!r8N) rRrTrUrV classmethodr2rrrrgrzrMr8r6rr sBB   [  [  [   [ "+"""["""r8rc,eZdZdZeefdZdS)raDefault variable lookup mechanism for expressions. When an undefined variable is referenced using this lookup style, the reference evaluates to an instance of the `Undefined` class: >>> expr = Expression('nothing', lookup='lenient') >>> undef = expr.evaluate({}) >>> undef The same will happen when a non-existing attribute or item is accessed on an existing object: >>> expr = Expression('something.nil', lookup='lenient') >>> expr.evaluate({'something': dict()}) See the documentation of the `Undefined` class for details on the behavior of such objects. :see: `StrictLookup` c(d}t||S)zReturn an ``Undefined`` object.Tr)rrrrjr^s r6rzzLenientLookup.undefinedhs"E****r8NrRrTrUrVrrgrzrMr8r6rrPsA."++++[+++r8rc,eZdZdZeefdZdS)raStrict variable lookup mechanism for expressions. Referencing an undefined variable using this lookup style will immediately raise an ``UndefinedError``: >>> expr = Expression('nothing', lookup='strict') >>> try: ... expr.evaluate({}) ... except UndefinedError as e: ... print(e.msg) "nothing" not defined The same happens when a non-existing attribute or item is accessed on an existing object: >>> expr = Expression('something.nil', lookup='strict') >>> try: ... expr.evaluate({'something': dict()}) ... except UndefinedError as e: ... print(e.msg) {} has no member named "nil" c(d}t||)z(Raise an ``UndefinedError`` immediately.Tr)rrs r6rzzStrictLookup.undefineds"S....r8NrrMr8r6rrosA."+///[///r8rr&c|}|dkrd|D}|r|d}td|dd}|drK|ds1dd|D}d||g}t|trd|z d }t||S) Nrac6g|]}|SrM) expandtabs.0lines r6 z_parse..s"CCCt""CCCr8r r:cg|]}d|zS)z %srMrs r6rz_parse..s!P!P!Pd(T/!P!P!Pr8uutf-8) strip splitlinesrjoinrstripendswithisspacer+rencoder )rr$linesfirstrests r6r,r,s# \\^^F v~~CCv/@/@/B/BCCC  .!HE$))E!""I..//6688D||~~&&s++ RDGOO4E4E Ryy!P!Pdoo>O>O!P!P!PQQYYt}--F&)$$6f$,,W55   r8Nr!c|sd}tr,t|tr|dd}n+t|ts|dd}|dkrd}|"dt i|t}||}|dkrd|pdz}n>| }|sd } n|d} t|dkr| d z } d | z}t|j } t| ||} t| |||S#t$r| cYSwxYw) Nzrreplacerrr&zr%z ...z )rr+rrdecodeExpressionASTTransformerrTemplateASTTransformervisitrrr rcompiler RuntimeError) r5rr$r'r(r)treerirextract new_sourcers r6r1r1su ; h * * ;w ::H(I.. ;w ::H {{ } , #d* + +  577==  D v~~ FMc2!!## GGAhG u::>> v Gw'!$'',J :x . .D hf===  sD00 D?>D?c|}t|j|D])\}}||vrtdt|||*|D]\}}t||||S)Nz!Field set both in args and kwargs)zip_fields ValueErrorsetattr)class_r}r~retattrvalues r6_newrs &((C3;--"" e 6>>@AA AT5!!!!"" eT5!!!! Jr8)r r)FalseTrueNoneNotImplementedEllipsisc^eZdZdZdZdZdZdZdZdZ dZ d Z d Z e Z d Zd Zd ZdS)rpConcrete AST transformer that implements the AST transformations needed for code embedded in templates. c tg|_dSrC) CONSTANTSlocalsrJs r6r7zTemplateASTTransformer.__init__s k r8c*ts6t|tjr||jdSt |r||dSt|tjr||jdSt|tjr#||j p|j dSt|tj r |j D]}| ||dSdSrC)rr+r-argaddrNameidaliasasnameriTupleelts_process)r3namesr5elts r6rzTemplateASTTransformer._processs  *jtx88 * IIdh      d^^ * IIdOOOOO di ( ( * IIdg      dj ) ) * IIdk.TY / / / / / dj ) ) *y * * eS)))) * * * *r8ct}t|dr|jD]}|||t|dr |jD]}|||t|dr|||jt|dr|||jn0t|dr |jD]}||||S)Nr} kwonlyargsvarargkwargr)setr;r}rrrrr)r3r5rrrs r6_extract_namesz%TemplateASTTransformer._extract_namess 4 *y * * eS))))t\** .?..CMM%----tX&& 2 eT[111tW%% 1 eTZ000 T7 # # *z * * eS)))) r8ct|jtsY |jdn=#t$r0t t |jdcYSwxYw|S)Nasciir)r+srrrrrr3r5s r6 visit_Strz TemplateASTTransformer.visit_Strsv$&),, > > g&&&& > > >HdfmmG&<&<===== > s77A10A1cbt|jdkr%|jd|j|jt  t j|||jS#|jwxYwNrr!) rrrriappendrr visit_ClassDefpoprs r6rz%TemplateASTTransformer.visit_ClassDefs t{  a   KO   * * * 355!!! !0t<< KOO    DKOO    s %BB.ct|jdkr3|jd||t j||Sr)rrupdaterr visit_Importrs r6rz#TemplateASTTransformer.visit_ImportsR t{  a   KO " "4#6#6t#<#< = = =*4666r8cd|jDdgkr|St|jdkr3|jd||t j||S)Ncg|] }|j SrM)ri)ras r6rz;TemplateASTTransformer.visit_ImportFrom..s ' ' 'qAF ' ' 'r8*rr!)rrrrrr visit_ImportFromrs r6rz'TemplateASTTransformer.visit_ImportFromst ' 'DJ ' ' 'C5 0 0K t{  a   KO " "4#6#6t#<#< = = =.tT:::r8czt|jdkr%|jd|j|j||j tj|||j S#|j wxYwr) rrrrirrr}r visit_FunctionDefrrs r6rz(TemplateASTTransformer.visit_FunctionDefs t{  a   KO   * * * 4..ty99::: !3D$?? KOO    DKOO    s 1BB:cg}|jD]}jtt t j|j|j fd|j D}||t |j |j |}jt|j d=|S)Nc:g|]}|SrM)r)rif_r3s r6rz=TemplateASTTransformer.visit_GeneratorExp..-s#AAAC 3AAAr8) generatorsrrrrr- comprehensionrtargetrqifsrrr)r3r5gens generatorgenrs` r6visit_GeneratorExpz)TemplateASTTransformer.visit_GeneratorExp&s  I K  suu % % %t)4::i6F+G+Gzz).11AAAA9=AAACCC KK    4>4::dh#7#7>> KT_---.. / r8c|j||j t j|||jS#|jwxYwrC)rrrr}r visit_Lambdarrs r6rz#TemplateASTTransformer.visit_Lambda9sj 4..ty99::: !.tT:: KOO    DKOO    s A""A=cD||j|_|SrC)rrrs r6 visit_Starredz$TemplateASTTransformer.visit_StarredAsZZ ++  r8cTt|jtjr|jt |jvrttjdtj}ttjdtj}tt|j}ttj |||gg}n\t|jtj r=t|jdkr%|jd |j|S)Nrr[rr!)r+ctxr-LoadrrrrrrCallStorerr)r3r5rinameargstrargs r6 visit_Namez!TemplateASTTransformer.visit_NameEs dh * * -wt{3333 >49;;??D49j$)++>>G(DG,,F 4'6):B??DD $* - - -4;!## B##DG,,, r8N)rRrTrUrVr7rrrrrrrrvisit_ListComprrrrMr8r6rrs""" * * *"777 ;;;"(Nr8rceZdZdZdZdZdS)rrcbt|jtjst j||St tjdtj}||j t t|j g}t tj ||gS)Nr) r+rr-rr visit_Attributerrrrrrr)r3r5funcr}s r6rz(ExpressionASTTransformer.visit_Attribute[s~$(DI.. >!1$== =DI~ty{{;; 4:&&Xty(A(ABDItT2...r8ct|jtjrtzDJ tyRVR[+\]] >!1$== = dj49di"8 9 9 +*KK**KDI~ty{{;; JJtz " " djj557 E E DItT2...r8N)rRrTrUrVrr$rMr8r6rrVs<////////r8r)r&)Nr&Nr!N)3rVtextwraprtypesr genshi.compatrrrr genshi.corer genshi.template.astutilr r r genshi.template.baser genshi.utilrrr-rrrrrr__all__ __docformat__objectrrrrgrrrrrr,r1r__dict__copyrr frozensetrrrrMr8r6r3s;:BBBBBBBBBBBBKKKKKKKKKK555555KKKKKKKKKKKKKKKKKK * * *% E=E=E=E=E=6E=E=E=P4=4=4=4=4=4=4=4=n)))))D)))* FHH  5 5 5 5 5) 5 5 5CCCCCCCCL@"@"@"@"@"@"@"@"F+++++J+++>/////:///>    DF((((V   ! ! # #6 ::;;; IMMM N N {{{{{^{{{|/////5/////r8