V?q d Z ddlZddlZddlZddlmZ ddlmZ ddlmZ G d d Z G d d e Z
G d
d Z e Z d Z
G d
d Z G d d Z G d d Z G d d Z G d de Z G d de Zd Zd Zd Zd Zd Zd Zd Zd(d Zd)d"Z d# Z d$ Z d% Z d*d&Z d' Z!dS )+zdprovides runtime services for templates, including Context,
Namespace, and various helper functions. N)compat)
exceptions)utilc e Zd ZdZd Zd Zed Zed Zd Z d Z
d Z d Z d
Z
d Zd Zd
ZddZd Zd Zd Zd Zd ZdS )ContextzProvides runtime namespace, output buffer, and various
callstacks for templates.
See :ref:`runtime_toplevel` for detail on the usage of
:class:`.Context`.
c |g| _ || _ | | _ d | _ d | _ i | _ t j t | | j d< t x| _ | j d< d S )Ncapturecaller)
_buffer_stack_datacopy_kwargs_with_template_outputting_as_unicode
namespaces functoolspartialr CallerStack caller_stack)selfbufferdatas ^/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/mako/runtime.py__init__zContext.__init__ st $X
yy{{ "&*# !* 1'4 @ @
9 4?==@DJx 0 0 0 c || _ |j | j }|r*t j dd | z d S )Nz%Reserved words passed to render(): %sz, )r reserved_names intersectionr r NameConflictErrorjoin)r t
illegal_namess r _set_with_templatezContext._set_with_template. s` (55djAA
.7))M**+
r c | j j S )z]Return the :class:`.TemplateLookup` associated
with this :class:`.Context`.
)r lookupr s r r% zContext.lookup7 s "))r c 4 | j S )a] Return 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 r kwargszContext.kwargs? s ( | """r c : | j | dS )zQPush a ``caller`` callable onto the callstack for
this :class:`.Context`.N)r append)r r
s r push_callerzContext.push_callerU s!
(((((r c | j d= dS )zPPop a ``caller`` callable onto the callstack for this
:class:`.Context`.N)r r& s r
pop_callerzContext.pop_caller[ s
b ! ! !r c N t | j S )zAReturn a list of all names established in this :class:`.Context`.)listr keysr& s r r1 z Context.keysa s DJOO%%&&&r c R || j v r
| j | S t j | S N)r builtins__dict__r keys r __getitem__zContext.__getitem__f s) $* :c? "$S) )r c j t j }| j | |j S )zUpush a capturing buffer onto this Context and return
the new writer function.)r FastEncodingBufferr r* writer bufs r _push_writerzContext._push_writerl s1 %'' !!#&&&yr c \ | j }|| j d j fS )zupop the most recent capturing buffer from this Context
and return the current writer after the pop.
r- )r popr; r< s r _pop_buffer_and_writerz Context._pop_buffer_and_writert s. $$&&D&r*000r c . | dS )z*push a capturing buffer onto this Context.N)r> r& s r _push_bufferzContext._push_buffer} s
r c 4 | j S )z7pop the most recent capturing buffer from this Context.)r r@ r& s r _pop_bufferzContext._pop_buffer s !%%'''r Nc t | j |t j || S )z+Return a value from this :class:`.Context`.)r getr4 r5 )r r7 defaults r rG z Context.get s- z~~c8#4#8#8g#F#FGGGr c F | j d | dS )zSWrite a string to this :class:`.Context` object's
underlying output buffer.r- Nr r; )r strings r r; z
Context.write s&
2 $$V,,,,,r c & | j d j S )z#Return the current writer function.r- rJ r& s r writerzContext.writer s !"%++r c t t }| j |_ | j |_ | j |_ | j |_ | j |_ | j |_ | j |_ |S r3 )
r __new__r r r
r r r r r )r cs r _copyz
Context._copy sg OOG $ $ ,*//##L .#'#> *r c j |s| S | }|j | |S )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.
)rQ r update)r drP s r _localszContext._locals s7 K JJLL qr c | }|j }| dd | dd | dd |S )zfcreate a new copy of this :class:`.Context`. with
tokens related to inheritance state removed.r Nparentnext)rQ r r@ )r rP xs r _clean_inheritance_tokensz!Context._clean_inheritance_tokens sY
JJLL
G fd h fdr r3 )__name__
__module__ __qualname____doc__r r# propertyr% r( r+ r. r1 r8 r> rA rC rE rG r; rM rQ rU rZ r r r r sP A A A" * * X* # # X#*) ) ) " " " ' ' '
* * * 1 1 1
( ( (
H H H H
- - - , , ,
" r r c 8 e Zd Zd Zd Zd Zd Zd Zd Zd Z dS ) r c d | _ d S r3 )
nextcallerr& s r r zCallerStack.__init__ s
r c * | S r3 __bool__r& s r __nonzero__zCallerStack.__nonzero__ }} r c P t | r| rdpdS )NTF)len _get_callerr& s r rf zCallerStack.__bool__ s) 4yy8T - - / /8DAEAr c | d S Nr- r` r& s r rk zCallerStack._get_caller s
Bxr c F t | | S r3 )getattrrk r6 s r __getattr__zCallerStack.__getattr__ s t''))3///r c P | j pd }| | d | _ |S r3 )rc r* )r frames r _push_framezCallerStack._push_frame s, '4 E r c 8 | | _ d S r3 )r@ rc r& s r
_pop_framezCallerStack._pop_frame s ((**r N)
r[ r\ r] r rg rf rk rp rs ru r` r r r r s B B B
0 0 0 % % % % %r r c $ e Zd ZdZd Zd Zd ZdS ) UndefinedzRepresents an undefined value in a template.
All template modules have a constant value
``UNDEFINED`` present which is an instance of this
object.
c t d )Nrw ) NameErrorr& s r __str__zUndefined.__str__ s $$$r c * | S r3 re r& s r rg zUndefined.__nonzero__ rh r c dS )NFr` r& s r rf zUndefined.__bool__ s ur N)r[ r\ r] r^ rz rg rf r` r r rw rw sK % % % r rw c R e Zd ZdZd Zd Zd Zed Zd Z d Z
d Z d Z d
S ) LoopStackza stack for LoopContexts that implements the context manager protocol
to automatically pop off the top of the stack on context exit
c g | _ d S r3 stackr& s r r zLoopStack.__init__ s
r c : | | | j S r3 )_push_topr iterables r _enterzLoopStack._enter s
8 yr c 8 | | j S r3 )_popr r& s r _exitzLoopStack._exit s yr c . | j r
| j d S | S rm r r& s r r zLoopStack._top s : :b> !Kr c 4 | j S r3 )r r@ r& s r r zLoopStack._pop s z~~ r c t | }| j r| j d |_ | j | S rm ) LoopContextr rW r* )r r news r r zLoopStack._push s< (## : ( B CJz %%%r c * t j d )Nz No loop context is established)r RuntimeExceptionr6 s r rp zLoopStack.__getattr__ s )*JKKKr c * t | j S r3 )iterr r& s r __iter__zLoopStack.__iter__ s DI r N)
r[ r\ r] r^ r r r r_ r r r rp r r` r r r r s X & & & L L L r r c e Zd ZdZd Zd Zej d Ze d Z
e d Z e d Z e d Z
e d Zd
Zd S ) r a A 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 0 || _ d| _ d | _ d S Nr ) _iterableindexrW r s r r zLoopContext.__init__3 s !
r c # F K | j D ]}|V | xj dz
c_ d S N )r r )r is r r zLoopContext.__iter__8 s; AGGG JJ!OJJJ r c * t | j S r3 )rj r r& s r __len__zLoopContext.__len__= s 4>"""r c 6 t | | j z
dz
S r )rj r r& s r
reverse_indexzLoopContext.reverse_indexA s 4yy4:%))r c | j dk S r )r r& s r firstzLoopContext.firstE s zQ r c 8 | j t | dz
k S r )r rj r& s r lastzLoopContext.lastI s zSYY]**r c | j S r3 )oddr& s r evenzLoopContext.evenM s 8|r c 0 t | j dz S )N )boolr r& s r r zLoopContext.oddQ s DJN###r c ^ |st d || j t | z S )z,Cycle through values as the loop progresses.z(You must provide values to cycle through)
ValueErrorr rj )r valuess r cyclezLoopContext.cycleU s2 I GHH Hdj3v;;.//r N)r[ r\ r] r^ r r r memoized_instancemethodr r_ r r r r r r r` r r r r s ,
!# # "!# * * X* X + + X+ X $ $ X$0 0 0 0 0r r c e Zd Zd Zd ZdS )_NSAttrc || _ d S r3 )_NSAttr__parent)r rW s r r z_NSAttr.__init__] s
r c | j }|r3t |j | rt |j | S |j }|3t | r3 )r hasattrmodulero inheritsAttributeError)r r7 nss r rp z_NSAttr.__getattr__` sX
] !ry#&&
! ry#...[ !
S!!!r N)r[ r\ r] r rp r` r r r r \ s2 " " " " "r r c e Zd ZdZ ddZdZdZ dZ dZ dZ dZ
dZ e j
d Zd Zd Zd Zed
Zd Zd Zd
Zd ZdS ) Namespacea Provides 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.
NTc Z || _ || _ || _ |d |D | _ d S d S )Nc i | ]
}|j | S r` r[ .0rP s r
z&Namespace.__init__.. ? ? ?aj! ? ? ?r )namecontextr callables)r r r r r
populate_self calling_uris r r zNamespace.__init__{ s@
? ?Y ? ? ?DNNN ! r r` c t | S )a- Access 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`
)r r& s r attrzNamespace.attr s t}} r c | |f}|| j j v r| j j | S t || j || j }|| j j |< |S )a] Return 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 )r r TemplateNamespacerQ _templateuri)r urir7 r s r
get_namespacezNamespace.get_namespace st ( Sk $,) ) )<*3/ /
L )
(* $ r c 8 t | j || j S )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_templater r )r r s r get_templatezNamespace.get_template s c43DEEEr c ( | j j |fi |S )a Return 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>``.
)cacherG )r r7 r( s r
get_cachedzNamespace.get_cached s tz~c,,V,,,r c | j j S )zReturn the :class:`.Cache` object referenced
by this :class:`.Namespace` object's
:class:`.Template`.
)templater r& s r r zNamespace.cache s }""r c 8 t | j || j fi | dS )z$Include a file at the given ``uri``.N)
_include_filer r )r r r( s r include_filezNamespace.include_file
s) dlC):EEfEEEEEr c |D ];}|dk r | D ]
\ }}|||< (t | | ||< 1~
1
1DN3 /00000 1 1
1
1r c || j v r| j | }n8| j rt | j | }nt d| j d|d t | || |S Nz Namespace 'z' has no member '')r r ro r r setattr)r r7 vals r rp zNamespace.__getattr__ sy $. .%CC
] $---CC .7;yyy###F
c3
r NNTN)r[ r\ r] r^ r r r r r filenamer r r memoized_propertyr r r r r_ r r r r rp r` r r r r j s4
&
@
@
@
@ I
F H
G H C L @F F F - - - # # X#F F F
0 0 01 1 1
r r c t e Zd ZdZ d
dZed Zed Zed Zd Z d Z
dS ) r z@A :class:`.Namespace` specific to a :class:`.Template` instance.NTc D || _ || _ || _ |d |D | _ |-t ||| | _ | j j j | _ n*||| _ |j j | _ nt d |r t || j | \ } }
d S d S )Nc i | ]
}|j | S r` r r s r r z.TemplateNamespace.__init__..? r r z 'template' argument is required.)self_ns) r r r r r r r
_template_urir TypeError_populate_self_namespace) r r r r r r r r r lclcallable
lclcontexts r r zTemplateNamespace.__init__0 s
? ?Y ? ? ?DN " ,Wk; O ODM $
4 BD
! $DM ( =D >?? ? &> ' ' ' #K r c | j j S )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.
)r r r& s r r zTemplateNamespace.moduleO s }##r c | j j S zhThe path of the filesystem file used for this
:class:`.Namespace`'s module or template.
)r r r& s r r zTemplateNamespace.filenameZ s
}%%r c | j j S )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`.
)r r r& s r r zTemplateNamespace.uria s } r c # K j r j D ]}| j | fV fd} j j j D ]}| || fV d S )Nc l j | }t j |j S r3 )r _get_def_callabler r r )r7 callable_r s r rG z(TemplateNamespace._get_star..getq s-
77< 1~
1
1DN3 /00000 > > > > > %. Acc!ff+ r c d || j v r| j | }n| j | r5| j | }t j || j }n8| j rt | j | }nt d| j
d|d t | || |S r ) r r has_defr r r r r ro r r r r r7 r r s r rp z TemplateNamespace.__getattr__x s $. .%CC
]
"
"3
'
'
77< $ $ X$ & & X& ! ! X!
r r c D e Zd ZdZ ddZed Zd Zd ZdS ) ModuleNamespacez;A :class:`.Namespace` specific to a Python module instance.NTc || _ || _ || _ |d |D | _ t | }| d dd D ]} t
|| }|| _ d S )Nc i | ]
}|j | S r` r r s r r z,ModuleNamespace.__init__.. r r .r )r r r r
__import__splitro r )
r r r r r r r r modtokens
r r zModuleNamespace.__init__ s
? ?Y ? ? ?DN \\#&&qrr* & &E#u%%CC r c | j j S r )r __file__r& s r r zModuleNamespace.filename s
{##r c # K | j r| j D ]}|| j | fV t | j D ]P}|d dk rBt | j | }t | r |t j || j fV Qd S )Nr _)r dirr ro callabler r r )r r7 r s r r zModuleNamespace._get_star s > 1~
1
1DN3 /00000t{## J JC1v}} #DK 5 5 I&& J y 0DL I IIIII J Jr c P || j v r| j | }n}t | j | r0t | j | }t j || j }n8| j rt | j | }nt d| j d|d t | || |S r ) r r r ro r r r r r r r r s r rp zModuleNamespace.__getattr__ s $. .%CC
T[#
&
& S11I#It|<.wrap_stackframe sm ((*** .41$111&11 + + - - - -G + + - - - -s A A r` )r r s ` r supports_callerr s$ . . . . . r c t | st j d | ||i | | }n# | }w xY w| S )zExecute 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)))r r r rC rE getvalue)r r r r( r= s r r r s I
)
A
$ 4"6"""!!##g!!###### <<>>s A A,c fd}|S )Nc fd}|S )Nc fd} j dd |_ n# t $ r Y nw xY w | g|R i |S )Nc g| R i |S r3 r` )r kwr render_fns r yzB_decorate_toplevel..decorate_render..go..y s# y646662666r )r[ r )r r r r! fnr s ` r goz7_decorate_toplevel..decorate_render..go s
7
7
7
7
7
7
& / 3
22a55.4...2.. .s
,,r` )r r$ r# s ` r decorate_renderz+_decorate_toplevel..decorate_render s) / / / / / / r r` )r# r% s ` r _decorate_toplevelr& s$ r c fd}|S )Nc , | fd}|S )Nc g| R i |S r3 r` )r r r decs r r$ z5_decorate_inline..decorate_render..go s# 3w,,,,,, ,r r` )r r$ r* r r# s @r r% z)_decorate_inline..decorate_render s6 bmm - - - - - - r r` )r r# r% s `` r _decorate_inliner+ s* r c F t | || }t | | \ }}t || j fi |}|j rG ||fi | dS # t $ r. | |t j }|s Y dS w xY w ||fi | dS )zPlocate the template from the given uri and include it in
the current output.N) r r rZ _kwargs_for_includer include_error_handler Exceptionr exception_as)r r r r( r r ctxresults r r r s k::H/))++X Y !GM
D
DV
D
DF% ! Ic $ $V $ $ $ $ $ 33C9L9N9NOOF
# s A 4BBc |dS t | || }| d }|}|j |j }|j | d|i }t d|j z ||d |_ |j x| j d< |j d< t
|j d d }| ||| }|r|S t
|j d
d } | | | |j |fS ) zcalled by the _inherit method in template modules to set
up the inheritance chain at the start of a template's
execution.Nr rX self:%sFr r rW local
_mako_inherit_mako_generate_namespaces) r r rU r r r ro r r )
r r r r r ihr r retgen_nss
r
_inherit_fromr< s
{t k::HfoG B
+
!
[
+
! &" ..J#HL BK ;=+EGM(j .w 7 $??I i*-- J
X_&A4
H
HF
w
++r c L | j j }|!t j d| j j z | || } | | S # t j $ r8}t j t t j
|d }~ww xY w)Nz.Template '%s' has no TemplateLookup associated) r r% r TemplateLookupExceptionr
adjust_urir TopLevelLookupExceptionstrr r0 )r r
relativetor% es r r r < s
#
*F
~0 <$(
)
C
,
,C""3''' - 0 #%% & &
s A B#+3B B#c |t d|j z | |d }|x| j d< | j d< t |j d r |j || }|r|S |j | fS )Nr4 Fr5 r r6 r7 )r r r r r r7 r )r r r r: s r r r L s # $
6=> J ((r Fc L |rt j }n t j | j | j }t |fi |}||_ | | t | ||g|R i t || |
S )z^create a Context and return the string
output of the given template and template callable.)encodingerrors) r r: output_encodingencoding_errorsr r r# _render_context_kwargs_for_callablerE r )r r r r
as_unicoder= r s r _renderrM \ s
%''% -h6N
c""T""G%/G" x(((
y$
/
/ ) ) + ++r c t j | }|d r|S |d d |dd D z }i }|D ]}|dk r||v r||vr || ||< |S )Nr r c g | ]}||S r3 r` r r s r
z(_kwargs_for_callable..{ G G GA a r r r r inspect_getargspec)r r argspec namedargsr( args r rK rK t s ' 22Gqz
G G1 G G GGI
F $ $ ) t 60A0A s)F3K Mr c t j | }|d d |dd D z }|D ]}|dk r||v r||vr || ||< |S )Nr c g | ]}||S r3 r` rP s r rQ z'_kwargs_for_include.. rR r r rS r rT )r r r( rV rW rX s r r- r- sv ' 22G
G G1 G G GGI $ $ ) t 60A0A s)F3K Mr c dd l m} t | |j s(t || \ }}t |||| d S t || j \ }}t |||| d S )Nr )r r( )
mako.templater
isinstance DefTemplater _exec_templaterW )tmplr r r r( r inheritr s r rJ rJ s $$$$$$ dH 0 1 1 E 8$ G G *w
fEEEEEE !9$+ N N *y'VDDDDDDr c * |j }|}|j s|j ro | |g|R i | dS # t $ r& t ||t j Y dS t j d }t ||| Y dS xY w | |g|R i | dS )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.
Nr ) r format_exceptions
error_handlerr/
_render_errorr r0 sysexc_info)r r r r( r rC s r r_ r_ s %H" &.&< 0 Ig / / / / / / / / / D D D (GV-@-B-B C C C C C C 0 q!A (GQ / / / / / / '+D+++F+++++s ' ,B+Bc | j rL| || }|s2t j \ }}}|r|r| | |d S t j }|j r t j g|j d d < n*t j |j
|j g|j d d < | | |
|| d S )N)error)rd rf rg with_tracebackr html_error_templater r r: r rH rI r# render_context)r r ri r2 tpvaluetberror_templates r re re s <''77 LNNMBr
**2... $799 ) (,(?(A(A'BG !!!! $ $ '"2"2 (G !!!! $ "">222%%gU%;;;;;r r3 )F)NN)"r^ r4 r rf makor r r r r0 r rw UNDEFINEDSTOP_RENDERINGr r r r r r r r r& r+ r r< r r rM rK r- rJ r_ re r` r r rt s , ,
i i i i i i i iX% % % % %$ % % %8 (
IKK % % % % % % % % P>0 >0 >0 >0 >0 >0 >0 >0B " " " " " " " " DZ Z Z Z Z Z Z Zz7 7 7 7 7i 7 7 7t $ * $ ! ! !( , , ,@
)
)
)
) , , , ,0 E E E , , , ,.< < < <