w:i^dZddlmZddlZddlmZmZmZmZm Z m Z ddl m Z m Z mZmZmZmZddlmZgdZdZGd d eZGd d eZGd deZGddeZGddeZdZddZddZGdde Z!ee!GddeZ"Gdde"Z#e#j$Z$e#j%Z%e#j&Z&e#j'Z'dS)zBasic templating functionality.)dequeN) add_metaclass numeric_types string_types text_typeStringIOBytesIO)AttrsStreamStreamEventKindSTARTTEXT_ensure) ParseError)ContextDirectiveFactoryTemplate TemplateErrorTemplateRuntimeErrorTemplateSyntaxErrorBadDirectiveErrorzrestructuredtext enceZdZdZddZdS)rz?Base exception class for errors related to template processing.Nc|d}||_|dks|dkr d|j||fz}t||||_||_||_dS)a9Create the exception. :param message: the error message :param filename: the filename of the template :param lineno: the number of line in the template at which the error occurred :param offset: the column number at which the error occurred Nzrz%s (%s, line %d))msg Exception__init__filenamelinenooffsetselfmessagerrr s L/var/www/html/trac/venv/lib/python3.11/site-packages/genshi/template/base.pyrzTemplateError.__init__sk  !H z ! !Vq[[(DHh+GGG4)))    Nrr__name__ __module__ __qualname____doc__rr%r$rrs.IIr%rceZdZdZddZdS)rz|Exception raised when an expression in a template causes a Python syntax error, or the template is not well-formed. Nrct|tr2|j+t|d|jzd}t ||||dS)a8Create the exception :param message: the error message :param filename: the filename of the template :param lineno: the number of line in the template at which the error occurred :param offset: the column number at which the error occurred Nz (line %d)) isinstance SyntaxErrorrstrreplacerrr!s r$rzTemplateSyntaxError.__init__8s` g{ + + N0J'll**<'.+H"MMGtWh?????r%r&r'r,r%r$rr3s8 @ @ @ @ @ @r%rceZdZdZddZdS)rzException raised when an unknown directive is encountered when parsing a template. An unknown directive is any attribute using the namespace for directives, with a local name that doesn't match any registered directive. NrcFt|d|z||dS)zCreate the exception :param name: the name of the directive :param filename: the filename of the template :param lineno: the number of line in the template at which the error occurred zbad directive "%s"N)rr)r"namerrs r$rzBadDirectiveError.__init__Ns5 $$T+?$+F%-v 7 7 7 7 7r%)Nrr'r,r%r$rrFs2 7 7 7 7 7 7r%rceZdZdZdS)rzfException raised when an the evaluation of a Python expression in a template causes an error. N)r(r)r*r+r,r%r$rrZsr%rcteZdZdZdZdZdZeZdZdZ dZ dZ dd Z dd Z d Zd ZdZdZdZdZd S)rapContainer for template input data. A context provides a stack of scopes (represented by dictionaries). Template directives such as loops can push a new scope on the stack with data that should only be available inside the loop. When the loop terminates, that scope can get popped off the stack again. >>> ctxt = Context(one='foo', other=1) >>> ctxt.get('one') 'foo' >>> ctxt.get('other') 1 >>> ctxt.push(dict(one='frost')) >>> ctxt.get('one') 'frost' >>> ctxt.get('other') 1 >>> ctxt.pop() {'one': 'frost'} >>> ctxt.get('one') 'foo' c t|g_jj_jj_g_g_fd}dfd }|d||d|dS)zZInitialize the template context with the given keyword arguments as data. c |vS)z]Return whether a variable with the specified name exists in the expression scope.r,)r6r"s r$definedz!Context.__init__..defineds4< r%Nc0||S)zIf a variable of the specified name is defined, return its value. Otherwise, return the provided default value, or ``None``.get)r6defaultr"s r$value_ofz"Context.__init__..value_ofs88D'** *r%r;r@N) rframespopleftpop appendleftpush_match_templates _choice_stack setdefault)r"datar;r@s` r$rzContext.__init__ysTFmm ;&K* "      + + + + + +  7+++  H-----r%cDtt|jSrA)reprlistrBr"s r$__repr__zContext.__repr__sD%%&&&r%c<||dduS)zuReturn whether a variable exists in any of the scopes. :param key: the name of the variable N)_find)r"keys r$ __contains__zContext.__contains__s zz#q!--r%c(|jD] }||vr||= dS)zaRemove a variable from all scopes. :param key: the name of the variable NrB)r"rSframes r$ __delitem__zContext.__delitem__s0 [  Ee||#J  r%cX||\}}|t||S)aGet a variables's value, starting at the current scope and going upward. :param key: the name of the variable :return: the variable value :raises KeyError: if the requested variable wasn't found in any scope )rRKeyError)r"rSvaluerWs r$ __getitem__zContext.__getitem__s-zz# u =3--  r%cDt|S)zReturn the number of distinctly named variables in the context. :return: the number of variables in the context )lenitemsrNs r$__len__zContext.__len__s 4::<<   r%c&||jd|<dS)zSet a variable in the current scope. :param key: the name of the variable :param value: the variable value rNrV)r"rSr[s r$ __setitem__zContext.__setitem__s $ Asr%Nc>|jD]}||vr |||fcS|dfS)a&Retrieve a given variable's value and the frame it was found in. Intended primarily for internal use by directives. :param key: the name of the variable :param default: the default value to return when the variable is not found NrVr"rSr?rWs r$rRz Context._findsB[ ) )Ee||Sz5((((}r%c6|jD]}||vr ||cS|S)zGet a variable's value, starting at the current scope and going upward. :param key: the name of the variable :param default: the default value to return when the variable is not found rVrds r$r>z Context.gets8[ " "Ee||Sz!!!r%cBg|jD]}fd|Dz S)zlReturn the name of all variables in the context. :return: a list of variable names cg|]}|v| Sr,r,).0rSkeyss r$ z Context.keys..s===SS__S___r%rV)r"rWris @r$riz Context.keyssA [ > >E ====E=== =DD r%cDfdDS)zReturn a list of ``(name, value)`` tuples for all variables in the context. :return: a list of variables c>g|]}||fSr,r=)rhrSr"s r$rjz!Context.items..s(<<<dhhsmm$<<rir_rnrFrDrvr,r%r$rr`s0...,'''... G   !!!$$$        ==='''   555     r%rcV|r&|dt||dd|fi|}|S)arApply the given directives to the stream. :param stream: the stream the directives should be applied to :param directives: the list of directives to apply :param ctxt: the `Context` :param vars: additional variables that should be available when Python code is executed :return: the stream with the given directives applied rrQN)iter)stream directivesruvarss r$_apply_directivesr}s?KAtF||Z^TJJTJJ Mr%c|r||||}|r||S)aEvaluate the given `Expression` object. :param expr: the expression to evaluate :param ctxt: the `Context` :param vars: additional variables that should be available to the expression :return: the result of the evaluation )rFevaluaterD)exprrur|retvals r$ _eval_exprrsF  $ ]]4 F   Mr%c |r*|||i|||rJ|}||jd|dSdS)zExecute the given `Suite` object. :param suite: the code suite to execute :param ctxt: the `Context` :param vars: additional variables that should be available to the code rN)rFexecuterDrBrn)suiterur|tops r$ _exec_suiter&s  $ "  MM$ #hhjj   Ac"""""##r%ceZdZdZdZdS)DirectiveFactoryMetaz#Meta class for directive factories.cd|vr-t|d|d<d|dD|d<t||||S)Nr{ _dir_by_namecg|] }|d S)rQr,)rh directives r$rjz0DirectiveFactoryMeta.__new__..>sMMM y|MMMr% _dir_order)dicttype__new__)clsr6basesds r$rzDirectiveFactoryMeta.__new__;sV 1   $Q|_ 5 5An MMQ|_MMMAlO||Cua000r%N)r(r)r*r+rr,r%r$rr8s)--11111r%rc$eZdZdZgZ dZdZdS)rz]Base for classes that provide a set of template directives. :since: version 0.6 c6|j|S)zReturn the directive class for the given name. :param name: the directive name as used in the template :return: the directive class :see: `Directive` )rr>)r"r6s r$ get_directivezDirectiveFactory.get_directiveOs $$T***r%cp||jvr|j|St|jS)aUReturn a key for the given directive class that should be used to sort it among other directives on the same `SUB` event. The default implementation simply returns the index of the directive in the `directives` list. :param dir_cls: the directive class :return: the sort key )rindexr^)r"dir_clss r$get_directive_indexz$DirectiveFactory.get_directive_indexXs7 do % %?((11 14?###r%N)r(r)r*r+r{rrr,r%r$rrCsH J+++ $ $ $ $ $r%rceZdZdZedZ edZ edZ edZ dZ e Z dd Z d Z d Zd Zd ZdZedZdZddZdZdZdZdZdS)rzAbstract template base class. This class implements most of the template processing model, but does not specify the syntax of templates. EXECEXPRINCLUDESUBNstrictTc|p||_||_||_||_||_||d|_t|tsDt|ds4t|trt|}nt|} ||||_dS#t $r+}t#|j|j|j|jd}~wwxYw)aInitialize a template from either a string, a file-like object, or an already parsed markup stream. :param source: a string, file-like object, or markup stream to read the template from :param filepath: the absolute path to the template file :param filename: the path to the template file relative to the search path :param loader: the `TemplateLoader` to use for loading included templates :param encoding: the encoding of the `source` :param lookup: the variable lookup mechanism; either "strict" (the default), "lenient", or a custom lookup class :param allow_exec: whether Python code blocks in templates should be allowed :note: Changed in 0.5: Added the `allow_exec` argument FreadN)filepathrloaderlookup allow_exec _init_filters _init_loader _preparedr0r hasattrrrr _parse_streamrrrrr ) r"sourcerrrencodingrres r$rzTemplate.__init__s(!,H     $  &&)) )'&&2I2I )&),, )!&))  P;;vx88DLLL P P P%aeT]AHahOO O Ps/C D&C<<DcB|j}g|d<|S)Nfilters)__dict__rvr"states r$ __getstate__zTemplate.__getstate__s$ ""$$i r%c<||_|dSrA)rrrs r$ __setstate__zTemplate.__setstate__s!  r%cBdt|jd|jdS)N)rr(rrNs r$rOzTemplate.__repr__s$"4jj1114===AAr%c,|j|jg|_dSrA)_flatten_includerrNs r$rzTemplate._init_filterss t}5 r%c|jddlm}|jr|j|jkr]t j|jdtt j|j }n't j |j}nd}|t j |g|_dSdS)Nr)TemplateLoader.) rgenshi.template.loaderrrrospathnormpathr^dirnameabspath)r"rbasedirs r$rzTemplate._init_loaders ;  = = = = = =} =DM11 g..t}==?9((77A9A9@9?9GG!goodm<z#Template._prepare..s qtr%)rSF auto_reloadT relative_tor)rrsetrrsortedattachappendrrMrr0rgetattrrload __class__addrrzdiscard)r"rzrrkindrJposr{ substream_rr[ namespacesreventhreffallback tmpl_inlinedtmpls r$rzTemplate._prepares <;;;;; ?4=*++G%6 *6 *OD$s{{  G 6<Q^^757575552AsE:s+.::dIu6@#,G,G(Iy 5")))444 MM)W== $T)__ =sBBBBB!*$$# $7??*.'D#x#(L"4660 ' ]D I I0 $&#';#3#3Dc!f8;8Mt~$4$O$ODD/&&&'/ % 0/& +#}G;; ' DM : : : $ 2 27 ; ; ;-1[!0!0E*/KKKK ' > > >/3 )-x)I)I,,&+ +/L#! >#S$ MM(G<<+>+> >c/))))c/))))m6 *6 *s *D44D?>D?c(i}|rFt|dksJ|d}| tdi|}n|}t|tsJn tdi|}|j}|jD]}|t ||fi|}t ||jS)aApply the template to the given context data. Any keyword arguments are made available to the template as context data. Only one positional argument is accepted: if it is provided, it must be an instance of the `Context` class, and keyword arguments are ignored. This calling style is used for internal processing. :return: a markup event stream representing the result of applying the template to the context data. rQrNr,)r^rr0rzrryr serializer)r"argskwargsr|rurzfilter_s r$generatezTemplate.generates  %t99>>>>7D|((((dG,, , , , ,$$V$$D| 9 9GWT&\\488488FFfdo...r%c+K|j}g}|j}|j}t|} |D]\}} } |tur| dr| \} } g} | D]c\}}t |t ur1d|j||fi|D}|s7d|}| ||fd|| t| f| fV|turt| ||}|t|tr t|| fVt|trt||| fVt!|dr||t#|}ntt%|| fVM|t&ur+||t)| d| d||}n3|t*urt-| |||| | fV|sdS|})NrQcLg|]!}|dtu|d|d"S)rrQ)r)rhrs r$rjz%Template._flatten..Ls>&&&$)#(8t#3#3a8L',Ah8L8L8Lr%r/__iter__r) _number_convrrDryr rrMrjoinr rrr0rrrrrrrr}rr)r"rzrur| number_convstackrFrDrrJrtagattrs new_attrsr6r[valuesresults r$rzTemplate._flatten;sm' |if5 #)4 4 dC5==T!W="&JC "I', 8 8 e;;$..&&-:T]5$-O-O$-O-O&&&F$*) ($&GGFOOE!(($7777eI&6&6 7<<<<<T\\'dD99F)&fl;; ?"&"33333' >>?"& F(;(;S"@@@@@$VZ88? DLLL%,V__F!E"& &(9(93">>>>S[[DLLL.tAwQtLLFET\\dD1111c/))))Ek5 r%c+6Kddlm}|D] }|dtur|d\}}}t|tsUg} |j||fi|D]$\} } } | t ur| | %dd| D} |j ||dd|p|j } | j |fi|D]}|V#|$r1||j D]}|t||fi|}|D]}|VYwxYw|VdS) z[Internal stream filter that performs inclusion of external template files. rrrQr/cg|]}||SrAr,)rhrs r$rjz%Template._include..s#F#F#F! A r%rN)rrrr0rrrrrrrrrrry)r"rzrur|rrrrrpartssubkindsubdatasubposrrs r$rzTemplate._includeys <;;;;;  EQx7""&+Ah#c8!$ 55HE4ADM$5J5JDH5J5J220&"d??!LL11177#F#Fu#F#F#FGGD $;++DeAhqk030Et~,GGD!.t!>4#H#H4#H#H!)$$# $$ $ /  sAC2DD)NNNNrTrA)r(r)r*r+r rrrrrrrrrrrOrrpropertyrzrrrrrrr,r%r$rrgsb ?6 " "DH ?6 " "D=oi((GK /% CJLDH<@%P%P%P%PN BBB666 E E EX " " """"" ?*?*?*B///<<<<|r%rrA)(r+ collectionsrr genshi.compatrrrrrr genshi.corer r r r rr genshi.inputr__all__ __docformat__rrrrrobjectrr}rrrrrrrrrrr,r%r$r s&% bbbbbbbbbbbbbbbbLLLLLLLLLLLLLLLL###### O O O% I.@@@@@-@@@&77777+777(= cccccfcccL   "####$111114111#$$ $ $ $ $ $v $ $%$ $Fooooooood }}  lr%