+ WBilrRt^RIt^RIt^RIt^RIHt^RIHt^RIHt!RR4t!RR] 4t !R R 4t ] !4t R t !R R 4t!RR4t!RR4t!RR4t!RR]4t!RR]4tRtRtRtRtRtRtRtR&RltR'R ltR!tR"tR#tR(R$lt R%t!R#))zdprovides runtime services for templates, including Context, Namespace, and various helper functions.N)compat) exceptions)utilca]tRt^toRtRtRt]R4t]R4t Rt Rt Rt R t R tR tR tR tRRltRtRtRtRtRtRtVtR#)ContextzProvides runtime namespace, output buffer, and various callstacks for templates. See :ref:`runtime_toplevel` for detail on the usage of :class:`.Context`. c V.VnW nVP4VnRVnRVn/Vn\P!\V4VPR&\4;Vn VPR&R#)Ncapturecaller) _buffer_stack_datacopy_kwargs_with_template_outputting_as_unicode namespaces functoolspartialr CallerStack caller_stack)selfbufferdatas&&,1/usr/lib/python3.14/site-packages/mako/runtime.py__init__Context.__init__sl$X yy{ "&*#!* 1 1'4 @ 94?=@DJJx0cWnVPPVP4pV'd-\P !RRP V4,4hR#)z%Reserved words passed to render(): %sz, N)rreserved_names intersectionr rNameConflictErrorjoin)rt illegal_namess&& r_set_with_templateContext._set_with_template.sQ((55djjA ..7))M*+  rc .VPP#)zMReturn the :class:`.TemplateLookup` associated with this :class:`.Context`. )rlookuprs&rr&Context.lookup7s "")))rc 6VPP4#)aReturn the dictionary of top level keyword arguments associated with this :class:`.Context`. This dictionary only includes the top-level arguments passed to :meth:`.Template.render`. It does not include names produced within the template execution such as local variable names or special names such as ``self``, ``next``, etc. The purpose of this dictionary is primarily for the case that a :class:`.Template` accepts arguments via its ``<%page>`` tag, which are normally expected to be passed via :meth:`.Template.render`, except the template is being called in an inheritance context, using the ``body()`` method. :attr:`.Context.kwargs` can then be used to propagate these arguments to the inheriting template:: ${next.body(**context.kwargs)} )r r r's&rkwargsContext.kwargs?s(||  ""rc <VPPV4R#)zIPush a ``caller`` callable onto the callstack for this :class:`.Context`.N)rappend)rr s&&r push_callerContext.push_callerUs   (rc VPRR#)zHPop a ``caller`` callable onto the callstack for this :class:`.Context`.N)rr's&r pop_callerContext.pop_caller[s   b !rc H\VPP44#)zAReturn a list of all names established in this :class:`.Context`.)listr keysr's&rr6 Context.keysasDJJOO%&&rcvWP9dVPV,#\PV,#N)r builtins__dict__rkeys&&r __getitem__Context.__getitem__fs+ ** ::c? "$$S) )rc z\P!4pVPPV4VP#)zMpush a capturing buffer onto this Context and return the new writer function.)rFastEncodingBufferr r-writerbufs& r _push_writerContext._push_writerls0%%' !!#&yyrc rVPP4pWPR,P3#)zepop the most recent capturing buffer from this Context and return the current writer after the pop. r1)r poprBrCs& r_pop_buffer_and_writerContext._pop_buffer_and_writerts2   $$&&&r*0000rc &VP4R#)z*push a capturing buffer onto this Context.N)rEr's&r _push_bufferContext._push_buffer}s rc 6VPP4#)z7pop the most recent capturing buffer from this Context.)r rHr's&r _pop_bufferContext._pop_buffers!!%%''rNc tVPPV\PPW44#)z+Return a value from this :class:`.Context`.)r getr:r;)rr=defaults&&&rrR Context.gets*zz~~c8#4#4#8#8#FGGrc JVPR,PV4R#)zKWrite a string to this :class:`.Context` object's underlying output buffer.Nr1r rB)rstrings&&rrB Context.writes 2$$V,rc <VPR,P#)z#Return the current writer function.r1rVr's&rwriterContext.writers!!"%+++rcB\P\4pVPVnVPP 4VnVP VnVP VnVPVnVPVnVPVn V#r9) r__new__r r r r rrrr)rcs& r_copy Context._copyss OOG $,,**//#LL ..#'#>#>  **rc pV'gV#VP4pVPPV4V#)zCreate a new :class:`.Context` with a copy of this :class:`.Context`'s current state, updated with the given dictionary. The :attr:`.Context.kwargs` collection remains unaffected. )r_r update)rdr^s&& r_localsContext._localss,K JJL qrc VP4pVPpVPRR4VPRR4VPRR4V#)z^create a new copy of this :class:`.Context`. with tokens related to inheritance state removed.rNparentnext)r_r rH)rr^xs& r_clean_inheritance_tokens!Context._clean_inheritance_tokenssG JJL GG fd h fdr)r r r rrrrr9)__name__ __module__ __qualname____firstlineno____doc__rr#propertyr&r*r.r2r6r>rErIrLrOrRrBrZr_rdrj__static_attributes____classdictcell__ __classdict__s@rrrsA"**##*) " ' * 1 ( H - , "  rrcJa]tRt^toRtRtRtRtRtRt Rt Rt Vt R #) rcRVnR#r9 nextcallerr's&rrCallerStack.__init__s rc"VP4#r9__bool__r's&r __nonzero__CallerStack.__nonzero__}}rcp\V4;'d#VP4;'d R;'gR#)TF)len _get_callerr's&rr}CallerStack.__bool__s-4y88T--/88DAAEArcVR,#r1r's&rrCallerStack._get_callers Bxrc6\VP4V4#r9)getattrrr<s&&r __getattr__CallerStack.__getattr__st'')3//rcbVP;'gRpVPV4RVnV#r9)ryr-)rframes& r _push_frameCallerStack._push_frames+''4 E rc0VP4VnR#r9)rHryr's&r _pop_frameCallerStack._pop_frames((*rrxN) rlrmrnrorr~r}rrrrrrrsrts@rrrs.B 0 %%rrc6a]tRt^toRtRtRtRtRtVt R#) UndefinedzRepresents an undefined value in a template. All template modules have a constant value ``UNDEFINED`` present which is an instance of this object. c\R4h)r) NameErrorr's&r__str__Undefined.__str__s  $$rc"VP4#r9r|r's&rr~Undefined.__nonzero__rrcR#Frr's&rr}Undefined.__bool__srrN) rlrmrnrorprr~r}rrrsrts@rrrs%rrc^a]tRt^toRtRtRtRt]R4t Rt Rt Rt R t R tVtR #) LoopStackza stack for LoopContexts that implements the context manager protocol to automatically pop off the top of the stack on context exit c.VnR#r9stackr's&rrLoopStack.__init__s  rc<VPV4VP#r9)_push_topriterables&&r_enterLoopStack._enters 8yyrc:VP4VP#r9)_poprr's&r_exitLoopStack._exits yyrcPVP'dVPR,#V#rrr's&rrLoopStack._tops :::::b> !Krc6VPP4#r9)rrHr's&rrLoopStack._pop szz~~rc\V4pVP'dVPR,VnVPPV4#r) LoopContextrrgr-)rrnews&& rrLoopStack._pushs9(# :::BCJzz  %%rc.\P!R4h)zNo loop context is established)rRuntimeExceptionr<s&&rrLoopStack.__getattr__s))*JKKrc,\VP4#r9)iterrr's&r__iter__LoopStack.__iter__sDIIrrN)rlrmrnrorprrrrqrrrrrrrrsrts@rrrsG  & Lrrca]tRtRtoRtRtRt]PR4t ] R4t ] R4t ] R4t ] R 4t] R 4tR tR tVtR #)rianA magic loop variable. Automatically accessible in any ``% for`` block. See the section :ref:`loop_context` for usage notes. :attr:`parent` -> :class:`.LoopContext` or ``None`` The parent loop, if one exists. :attr:`index` -> `int` The 0-based iteration count. :attr:`reverse_index` -> `int` The number of iterations remaining. :attr:`first` -> `bool` ``True`` on the first iteration, ``False`` otherwise. :attr:`last` -> `bool` ``True`` on the last iteration, ``False`` otherwise. :attr:`even` -> `bool` ``True`` when ``index`` is even. :attr:`odd` -> `bool` ``True`` when ``index`` is odd. c.Wn^VnRVnR#)N _iterableindexrgrs&&rrLoopContext.__init__3s!  rc#n"VPF pVxV;P^, unK" R#5i)rN)rr)ris& rrLoopContext.__iter__8s%AG JJ!OJ s35c,\VP4#r9)rrr's&r__len__LoopContext.__len__=s4>>""rcH\V4VP, ^, #r)rrr's&r reverse_indexLoopContext.reverse_indexAs4y4::%))rc VP^8H#)r)rr's&rfirstLoopContext.firstEszzQrc@VP\V4^, 8H#r)rrr's&rlastLoopContext.lastIszzSY]**rc$VP'*#r9)oddr's&revenLoopContext.evenMs88|rc:\VP^,4#))boolrr's&rrLoopContext.oddQsDJJN##rc lV'g \R4hWP\V4,,#)z,Cycle through values as the loop progresses.z(You must provide values to cycle through) ValueErrorrr)rvaluess&*rcycleLoopContext.cycleUs'GH Hjj3v;.//rrN)rlrmrnrorprrrmemoized_instancemethodrrqrrrrrrrrrsrts@rrrs,   !!#"#**++$$00rrc,a]tRtRtoRtRtRtVtR#)_NSAttri\cWnR#r9)_NSAttr__parent)rrgs&&rr_NSAttr.__init__]s rcVPpV'dA\VPV4'd\VPV4#VPpKH\ V4hr9)rhasattrmodulerinheritsAttributeError)rr=nss&& rr_NSAttr.__getattr__`sD ]]ryy#&&ryy#..[[S!!r)__parentN)rlrmrnrorrrrrsrts@rrr\s""rrca]tRtRtoRtRRltRtRtRtRt Rt Rt Rt ] PR4tRtRtRt]R 4tR tR tR tR tRtVtR#) NamespaceijakProvides access to collections of rendering methods, which can be local, from other templates, or from imported modules. To access a particular rendering method referenced by a :class:`.Namespace`, use plain attribute access: .. sourcecode:: mako ${some_namespace.foo(x, y, z)} :class:`.Namespace` also contains several built-in attributes described here. NcWnW nW@nVe$VUu/uFqwPVbK upVnR#R#uupir9)namecontextrrl callables)rrrrr populate_self calling_urir^s&&&&&&& rrNamespace.__init__{s=    5>?Yjj!mY?DN !?s<c \V4#)zAccess module level attributes by name. This accessor allows templates to supply "scalar" attributes which are particularly handy in inheritance relationships. .. seealso:: :ref:`inheritance_attr` :ref:`namespace_attr_for_includes` )rr's&rattrNamespace.attrst}rc W3pW PP9dVPPV,#\VVPP4VVPR7pW0PPV&V#)aReturn a :class:`.Namespace` corresponding to the given ``uri``. If the given ``uri`` is a relative URI (i.e. it does not contain a leading slash ``/``), the ``uri`` is adjusted to be relative to the ``uri`` of the namespace itself. This method is therefore mostly useful off of the built-in ``local`` namespace, described in :ref:`namespace_local`. In most cases, a template wouldn't need this function, and should instead use the ``<%namespace>`` tag to load namespaces. However, since all ``<%namespace>`` tags are evaluated before the body of a template ever runs, this method can be used to locate namespaces using expressions that were generated within the body code of the template, or to conditionally use a particular namespace. ) templateurir)rrTemplateNamespacer_ _templateuri)rurir=rs&& r get_namespaceNamespace.get_namespacesr(k ,,)) )<<**3/ /   LL   ))   (* $ rc B\VPWP4#)zReturn a :class:`.Template` from the given ``uri``. The ``uri`` resolution is relative to the ``uri`` of this :class:`.Namespace` object's :class:`.Template`. )_lookup_templaterr)rrs&&r get_templateNamespace.get_templates  c3D3DEErc <VPP!V3/VB#)aXReturn a value from the :class:`.Cache` referenced by this :class:`.Namespace` object's :class:`.Template`. The advantage to this method versus direct access to the :class:`.Cache` is that the configuration parameters declared in ``<%page>`` take effect here, thereby calling up the same configured backend as that configured by ``<%page>``. )cacherR)rr=r*s&&,r get_cachedNamespace.get_cachedszz~~c,V,,rc .VPP#)zgReturn the :class:`.Cache` object referenced by this :class:`.Namespace` object's :class:`.Template`. )templater r's&rr Namespace.caches}}"""rc H\VPWP3/VBR#)z$Include a file at the given ``uri``.N) _include_filerr)rrr*s&&,r include_fileNamespace.include_file s dllC):):EfErc~VF6pVR8Xd VP4F wrEWQV&K K)\W4W&K8 R#)*N) _get_starr)rrclidentkvs&&& r _populateNamespace._populates;E| NN,DAaD-#4/ rc#"VP'd,VPFpWPV,3xK R#R#5ir9)rr<s& rrNamespace._get_stars3 >>>~~NN3/00& sAAcWP9dVPV,pMGVP'd\VPV4pM\RVP: RV: R24h\ WV4V#z Namespace 'z' has no member '')rrrrrsetattr)rr=vals&& rrNamespace.__getattr__s] .. ..%C ]]]$---C 7;yy#F  3 r)rrrrNNTNr)rlrmrnrorprrrrrfilenamerrrmemoized_propertyrrrr rqr rrrrrrrsrts@rrrjs  @I FH GH CL  @F -##F 01  rrcja]tRtRtoRtR Rlt]R4t]R4t]R4t Rt R t R t Vt R#) ri,z@A :class:`.Namespace` specific to a :class:`.Template` instance.Nc WnW nW`nVe"VU u/uFqPV bK up VnVe8\ W$V4VnVP PPVn M1Ve#W0nVPPVn M \R4hV'd\W P VR7wrR#R#uup i)Nz 'template' argument is required.)self_ns) rrrrlrrrr _template_urir TypeError_populate_self_namespace) rrrrrrrrrr^ lclcallable lclcontexts &&&&&&&&& rrTemplateNamespace.__init__0s    5>?Yjj!mY?DN  ",W;ODM $ 4 4 B BD   !$M ( = =D >? ? &>' #K @sC c .VPP#)zThe Python module referenced by this :class:`.Namespace`. If the namespace references a :class:`.Template`, then this module is the equivalent of ``template.module``, i.e. the generated module for the template. )rrr's&rrTemplateNamespace.moduleOs}}###rc .VPP#zXThe path of the filesystem file used for this :class:`.Namespace`'s module or template. )rr'r's&rr'TemplateNamespace.filenameZs }}%%%rc .VPP#)zThe URI for this :class:`.Namespace`'s template. I.e. whatever was sent to :meth:`.TemplateLookup.get_template()`. This is the equivalent of :attr:`.Template.uri`. )rrr's&rrTemplateNamespace.urias}}   rc#a"SP'd+SPFpVSPV,3xK V3RlpSPPPFpW2!V43xK R#5i)c|<SPPV4p\P!VSP4#r9)r_get_def_callablerrr)r= callable_rs& rrR(TemplateNamespace._get_star..getqs. 77>>~~DNN3/00& >%%..Ac!f+ /sA7A:cWP9dVPV,pMVPPV4'd=VPPV4p\P !W0P 4pMGVP'd\VPV4pM\RVP: RV: R24h\WV4V#r!) rrhas_defr;rrrrrrrr#rr=r$r<s&& rrTemplateNamespace.__getattr__xs .. ..%C ]] " "3 ' ' 77$$&& !! rrcJa]tRtRtoRtR Rlt]R4tRtRt Rt Vt R#) ModuleNamespaceiz;A :class:`.Namespace` specific to a Python module instance.NcWnW nWPnVe"VUu/uFqPVbK upVn\ V4p VP R4R,Fp \W4p K WnR#uupi)N.:rNN) rrrrlr __import__splitrr) rrrrrrrrr^modtokens &&&&&&&& rrModuleNamespace.__init__so    5>?Yjj!mY?DN \\#&r**E#%C+ @sA5c .VPP#r5)r__file__r's&rr'ModuleNamespace.filenames {{###rc#v"VP'd*VPFpWPV,3xK \VP4F`pV^,R8wgK\VPV4p\ V4'gK<V\ P !W P43xKb R#5i)r_N)rdirrrcallablerrr)rr=r<s& rrModuleNamespace._get_stars >>>~~NN3/00&t{{#C1v}#DKK5 I&&y00LLIII $sAB9&$B9*B9cWP9dVPV,pM\VPV4'd8\VPV4p\P !W0P 4pMGVP'd\VPV4pM\RVP: RV: R24h\WV4V#r!) rrrrrrrrrrr#rBs&& rrModuleNamespace.__getattr__s .. ..%C T[[# & & S1I##I||.wrap_stackframesQ((* .1$1&1  + + -G + + -s AAr)rZr[sf rsupports_callerr]s. rc\V4'g\P!R4hVP4V!V/VBVP 4pVP 4# TP 4pi;i)z{Execute the given template def, capturing the output into a buffer. See the example in :ref:`namespaces_python_modules`. z[capture() function expects a callable as its argument (i.e. capture(func, *args, **kwargs)))rSrrrLrOgetvalue)rr<rYr*rDs&&*, rrrst I  )) A   $4"6"!!# <<>!!#s A!!A3caV3RlpV#)c<aVV3RlpV#)c<aVV3RlpSPR,VnS!V4!S.VO5/VB# \dLi;i)c<S!S.VO5/VB#r9r)rYkwr render_fns*,ryB_decorate_toplevel..decorate_render..go..ys 646266r:NN)rlr-)rrYrdrffnresf*, rgo7_decorate_toplevel..decorate_render..gosN 7 &//3 a5.4.2. .  s5 AAr)rerjrisf rdecorate_render+_decorate_toplevel..decorate_renders / rr)rirlsf r_decorate_toplevelrns  rcaaVV3RlpV#)c(<aS!V4oVV3RlpV#)c<S!S.VO5/VB#r9r)rYrdrdecs*,rrj5_decorate_inline..decorate_render..gosw,,, ,rr)rerjrrrris& @rrl)_decorate_inline..decorate_rendersm - rr)rrirlsff r_decorate_inlinerus rc P\WV4p\VP4V4wrV\WPP3/VBpVP 'd V!V3/VBR#V!V3/VBR# \ d3TP T\P!44pT'ghR#i;i)zLlocate the template from the given uri and include it in the current output.N) rr.rj_kwargs_for_includer include_error_handler Exceptionr exception_as)rrrr*rr<ctxresults&&&, rrrs k:H/))+XY!MM DV DF%%%  c $V $ #   33C9L9L9NOF s A((7B% B%$B%cVfR#\WV4pVR,pTpVPeVPpKVPRV/4p\RVP,VVRR7VnVP;VP R&VP R&\ VPR R4pVeV!W64pV'dV#\ VPR R4p V e V !V4VPV3#) zycalled by the _inherit method in template modules to set up the inheritance chain at the start of a template's execution.Nrrhself:%sFrrrglocal _mako_inherit_mako_generate_namespaces) rrrdrrr rrr<) rrrrr+ihr0r<retgen_nss &&& r _inherit_fromrs  {k:HfoG B ++ ! [[&".J#HLL  BK ;=++EGMM(j..w7$?I- J X__&A4 HF w    ++rc~VPPpVf2\P!RVPP,4hVP W4pVP V4# \Pd9p\P!\\P!444ThRp?ii;i)Nz.Template '%s' has no TemplateLookup associated) rr&rTemplateLookupExceptionr adjust_urirTopLevelLookupExceptionstrrrz)rr relativetor&es&&& rrr<s  # # * *F ~00 <$$(( )     C ,C""3''  - -00 ##% &  sA//B<3B77B<c$Vf!\RVP,VVRR7pV;VPR&VPR&\VPR4'd&VPP W4pV'dV#VP V3#)Nr~Frrrr)rrr rrrr<)rrr+rs&&& rr.r.Ls#  $    6= J    ((rcLV'd\P!4pM,\P!VPVPR7p\ V3/VBpWFnVP V4\VVV.VO5/\W4BVP4P4#)zZcreate a Context and return the string output of the given template and template callable.)encodingerrors) rrAoutput_encodingencoding_errorsrrr#_render_context_kwargs_for_callablerOr_)rr<rYr as_unicoderDrs&&&&& r_renderr\s%%'%%--h6N6N c"T"G%/" x(   y /     ) ) ++rc\P!V4pV^,'dV#V^,VR,Uu.uF q3fKVNK up,p/pVF&pVR8wgK Wa9gKWe9gKW,WV&K( V#uupi)rrNrrinspect_getargspec)r<rargspecr namedargsr*args&& rrrts{'' 2Gqzz  GAaaGGI F )  0A)FK M Hs BBc \P!V4pV^,VR,Uu.uF qDfKVNK up,pVF&pVR8wgK Wa9gKWb9gKW,W&&K( V#uupi)rrrr)r<rr*rrrrs&&, rrwrwsf'' 2G GAaaGGI )  0A)FK M Hs A1A1c^RIHp\WP4'g\ W 4wrg\ WgW4R7R#\ W P 4wrg\ WW4R7R#)rN)rYr*) mako.templater isinstance DefTemplater._exec_templaterg)tmplr<rrYr*rinheritr0s&&&*, rrrsL$ d00 1 1 8 GwE!9++ NyDrc\VPpVe4VP'gVP'dV!V.VO5/VBR#V!V.VO5/VBR# \d$\ YA\ P !44R#\P!4^,p\ YAT4R#;i)zexecute a rendering callable given the callable, a Context, and optional explicit arguments the contextual Template will be located if it exists, and the error handling options specified on that Template will be interpreted here. N) rformat_exceptions error_handlerry _render_errorrrzsysexc_info)r<rrYr*rrs&&&& rrrs%%H"""h&<&<&< 0 g / / / '+D+F+  D (V-@-@-B C 0 q!A (Q /s A*B+?)B+c$VP'dWVPW4pV'g<\P!4wrEpV'dV'dVPV4hVhR#\P !4pVP 'd%\P!4.VPR&M9\P!VPVP4.VPR&VPV4VPWR7R#):NNN)errorN)rrrwith_tracebackrhtml_error_templaterrrAr rrr#render_context)rrrr|tpvaluetberror_templates&&& rrrs''7LLNMBr**2.. $779  ) ) )(,(?(?(A'BG ! !! $''"22"22(G ! !! $ "">2%%g%;rr9r)NN)"rpr:rrmakorrrrr5rr UNDEFINEDSTOP_RENDERINGrrrrrrEr]rrnrurrrr.rrrwrrrrrrrs, iiX%$%8( K %%P>0>0B " "DZ Zz7i7t$*$ !(,@  ) ,0  E,.