File: //opt/alt/python37/lib/python3.7/site-packages/mako/__pycache__/runtime.cpython-37.pyc
B
�C]�m � @ sX d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ G dd� de �Z
G d d
� d
e �Z G d d � d e �Z
e
� Zd
ZG dd� de �ZG dd� de �ZG dd� de �ZG dd� de �ZG dd� de�ZG dd� de�Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Z d7d(d)�Z d8d+d,�Z d-d.� Z d/d0� Z d1d2� Z!d9d3d4�Z"d5d6� Z#dS ):zdprovides runtime services for templates, including Context,
Namespace, and various helper functions.� N)�compat)�
exceptions)�util)�compat_builtinsc @ s� e Zd ZdZdd� Zdd� Zedd� �Zedd � �Zd
d � Z d d
� Z
dd� Z dd� Z dd� Z
dd� Zdd� Zdd� Zd'dd �Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� ZdS )(�Contextz�Provides runtime namespace, output buffer, and various
callstacks for templates.
See :ref:`runtime_toplevel` for detail on the usage of
:class:`.Context`.
c K sR |g| _ || _|�� | _d | _d | _i | _t�t | �| jd< t
� | _ | jd< d S )N�capture�caller) �
_buffer_stack�_data�copy�_kwargs�_with_template�_outputting_as_unicode�
namespaces� functools�partialr � CallerStack� caller_stack)�self�buffer�data� r �=/opt/alt/python37/lib/python3.7/site-packages/mako/runtime.py�__init__ s
zContext.__init__c C s0 || _ |j�| j�}|r,t�dd�|� ��d S )Nz%Reserved words passed to render(): %sz, )r
Zreserved_names� intersectionr
r ZNameConflictError�join)r �tZ
illegal_namesr r r �_set_with_template. s zContext._set_with_templatec C s | j jS )z]Return the :class:`.TemplateLookup` associated
with this :class:`.Context`.
)r
�lookup)r r r r r 7 s zContext.lookupc C s
| 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 r r r �kwargs? s zContext.kwargsc C s | j �|� dS )zQPush a ``caller`` callable onto the callstack for
this :class:`.Context`.N)r �append)r r r r r � push_callerU s zContext.push_callerc C s | j d= dS )zPPop a ``caller`` callable onto the callstack for this
:class:`.Context`.���N)r )r r r r �
pop_caller[ s zContext.pop_callerc C s t | j�� �S )zAReturn a list of all names established in this :class:`.Context`.)�listr
�keys)r r r r r% a s z Context.keysc C s" || j kr| j | S tj| S d S )N)r
r �__dict__)r �keyr r r � __getitem__f s
zContext.__getitem__c C s t �� }| j�|� |jS )zUpush a capturing buffer onto this Context and return
the new writer function.)r �FastEncodingBufferr r �write)r �bufr r r � _push_writerl s zContext._push_writerc C s | j �� }|| j d jfS )zupop the most recent capturing buffer from this Context
and return the current writer after the pop.
r" )r �popr* )r r+ r r r �_pop_buffer_and_writert s
z Context._pop_buffer_and_writerc C s | � � dS )z*push a capturing buffer onto this Context.N)r, )r r r r � _push_buffer} s zContext._push_bufferc C s
| j �� S )z7pop the most recent capturing buffer from this Context.)r r- )r r r r � _pop_buffer� s zContext._pop_bufferNc C s | j �|tj�||��S )z+Return a value from this :class:`.Context`.)r
�getr r& )r r' �defaultr r r r1 � s z Context.getc C s | j d �|� dS )zSWrite a string to this :class:`.Context` object's
underlying output buffer.r" N)r r* )r �stringr r r r* � s z
Context.writec C s | j d jS )z#Return the current writer function.r" )r r* )r r r r �writer� s zContext.writerc C sJ t �t �}| j|_| j�� |_| j|_| j|_| j|_| j|_| j |_ |S )N)
r �__new__r r
r r r
r r r )r �cr r r �_copy� s
z
Context._copyc C s |s| S | � � }|j�|� |S )z�Create 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.
)r7 r
�update)r �dr6 r r r �_locals� s
zContext._localsc C s6 | � � }|j}|�dd� |�dd� |�dd� |S )zfcreate a new copy of this :class:`.Context`. with
tokens related to inheritance state removed.r N�parent�next)r7 r
r- )r r6 �xr r r �_clean_inheritance_tokens� s z!Context._clean_inheritance_tokens)N)�__name__�
__module__� __qualname__�__doc__r r �propertyr r r! r# r% r( r, r. r/ r0 r1 r* r4 r7 r: r> r r r r r s&
r c @ sD e Zd Zdd� Zdd� Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dS )r c C s
d | _ d S )N)�
nextcaller)r r r r r � s zCallerStack.__init__c C s | � � S )N)�__bool__)r r r r � __nonzero__� s zCallerStack.__nonzero__c C s t | �r| �� rdpdS )NTF)�len� _get_caller)r r r r rE � s zCallerStack.__bool__c C s | d S )Nr" r )r r r r rH � s zCallerStack._get_callerc C s t | �� |�S )N)�getattrrH )r r' r r r � __getattr__� s zCallerStack.__getattr__c C s | j pd }| �|� d | _ |S )N)rD r )r �framer r r � _push_frame� s
zCallerStack._push_framec C s | � � | _d S )N)r- rD )r r r r �
_pop_frame� s zCallerStack._pop_frameN)
r? r@ rA r rF rE rH rJ rL rM r r r r r � s r c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) � Undefinedz�Represents an undefined value in a template.
All template modules have a constant value
``UNDEFINED`` present which is an instance of this
object.
c C s t d��d S )NrN )� NameError)r r r r �__str__� s zUndefined.__str__c C s | � � S )N)rE )r r r r rF � s zUndefined.__nonzero__c C s dS )NFr )r r r r rE � s zUndefined.__bool__N)r? r@ rA rB rP rF rE r r r r rN � s rN � c @ sT e Zd ZdZdd� Zdd� Zdd� Zedd � �Zd
d � Z d d
� Z
dd� Z dd� Z dS )� LoopStackz�a stack for LoopContexts that implements the context manager protocol
to automatically pop off the top of the stack on context exit
c C s
g | _ d S )N)�stack)r r r r r � s zLoopStack.__init__c C s | � |� | jS )N)�_push�_top)r �iterabler r r �_enter� s
zLoopStack._enterc C s | � � | jS )N)�_poprU )r r r r �_exit s zLoopStack._exitc C s | j r| j d S | S d S )Nr" )rS )r r r r rU s
zLoopStack._topc C s
| j �� S )N)rS r- )r r r r rX s zLoopStack._popc C s& t |�}| jr| jd |_| j�|�S )Nr" )� LoopContextrS r; r )r rV �newr r r rT s zLoopStack._pushc C s t �d��d S )Nz No loop context is established)r �RuntimeException)r r' r r r rJ s zLoopStack.__getattr__c C s
t | j�S )N)�iterrU )r r r r �__iter__ s zLoopStack.__iter__N)
r? r@ rA rB r rW rY rC rU rX rT rJ r^ r r r r rR � s rR c @ sr e Zd ZdZdd� Zdd� Zejdd� �Ze dd � �Z
e d
d � �Z e d d
� �Z e dd� �Z
e dd� �Zdd� ZdS )rZ 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 C s || _ d| _d | _d S )Nr )� _iterable�indexr; )r rV r r r r 3 s zLoopContext.__init__c c s( x"| j D ]}|V | jd7 _qW d S )N� )r_ r` )r �ir r r r^ 8 s zLoopContext.__iter__c C s
t | j�S )N)rG r_ )r r r r �__len__= s zLoopContext.__len__c C s t | �| j d S )Nra )rG r` )r r r r �
reverse_indexA s zLoopContext.reverse_indexc C s
| j dkS )Nr )r` )r r r r �firstE s zLoopContext.firstc C s | j t| �d kS )Nra )r` rG )r r r r �lastI s zLoopContext.lastc C s | j S )N)�odd)r r r r �evenM s zLoopContext.evenc C s t | jd �S )N� )�boolr` )r r r r rg Q s zLoopContext.oddc G s |s t d��|| jt|� S )z5Cycle through values as the loop progresses.
z(You must provide values to cycle through)�
ValueErrorr` rG )r �valuesr r r �cycleU s zLoopContext.cycleN)r? r@ rA rB r r^ r Zmemoized_instancemethodrc rC rd re rf rh rg rm r r r r rZ s rZ c @ s e Zd Zdd� Zdd� ZdS )�_NSAttrc C s
|| _ d S )N)�_NSAttr__parent)r r; r r r r ^ s z_NSAttr.__init__c C s: | j }x&|r,t|j|�r$t|j|�S |j}qW t|��d S )N)ro �hasattr�modulerI �inherits�AttributeError)r r' �nsr r r rJ a s
z_NSAttr.__getattr__N)r? r@ rA r rJ r r r r rn ] s rn c @ s� e Zd ZdZddd�ZdZdZdZdZdZ dZ
dZ e j
dd� �Zd d
� Zd d � Zd
d� Zedd� �Zdd� Zdd� Zdd� Zdd� 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 C s2 || _ || _|| _|d k r.tdd� |D ��| _d S )Nc S s g | ]}|j |f�qS r )r? )�.0r6 r r r �
<listcomp>� s z&Namespace.__init__.<locals>.<listcomp>)�name�contextrr �dict� callables)r rx ry r{ rr �
populate_self� calling_urir r r r | s
zNamespace.__init__r c C s 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`
)rn )r r r r �attr� s zNamespace.attrc C sL | |f}|| j jkr | j j| S t|| j �� || jd�}|| j j|< |S dS )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} N)ry r �TemplateNamespacer7 � _templateuri)r �urir' rt r r r �
get_namespace� s
zNamespace.get_namespacec C s t | j|| j�S )z�Return a :class:`.Template` from the given ``uri``.
The ``uri`` resolution is relative to the ``uri`` of this
:class:`.Namespace` object's :class:`.Template`.
)�_lookup_templatery r� )r r� r r r � get_template� s zNamespace.get_templatec K s | j j|f|�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>``.
)�cacher1 )r r' r r r r �
get_cached� s zNamespace.get_cachedc C s | j jS )zReturn the :class:`.Cache` object referenced
by this :class:`.Namespace` object's
:class:`.Template`.
)�templater� )r r r r r� s zNamespace.cachec K s t | j|| jf|� dS )z$Include a file at the given ``uri``.N)�
_include_filery r� )r r� r r r r � include_file s zNamespace.include_filec C sH xB|D ]:}|dkr2x,| � � D ]\}}|||< q W qt| |�||< qW d S )N�*)� _get_starrI )r r9 �l�ident�k�vr r r � _populate s
zNamespace._populatec c s* | j r&x | j D ]}|| j | fV qW d S )N)r{ )r r' r r r r� s zNamespace._get_starc C sL || j kr| j | }n&| jr*t| j|�}ntd| j|f ��t| ||� |S )Nz!Namespace '%s' has no member '%s')r{ rr rI rs rx �setattr)r r' �valr r r rJ ! s
zNamespace.__getattr__)NNTN)r? r@ rA rB r r{ rq r� ry �filenamer� r� r Zmemoized_propertyr~ r� r� r� rC r� r� r� r� rJ r r r r ru k s*
! ru c @ sN e Zd ZdZddd�Zedd� �Zedd � �Zed
d � �Zd d
� Z dd� Z
dS )r� z@A :class:`.Namespace` specific to a :class:`.Template` instance.NTc C s� || _ || _|| _|d k r.tdd� |D ��| _|d k rRt|||�| _| jjj| _ n"|d k rl|| _|jj| _ nt
d��|r�t || j| d�\} }
d S )Nc S s g | ]}|j |f�qS r )r? )rv r6 r r r rw A s z.TemplateNamespace.__init__.<locals>.<listcomp>z 'template' argument is required.)�self_ns) rx ry rr rz r{ r� r� rq Z
_template_urir� � TypeError�_populate_self_namespace) r rx ry r� r r{ rr r| r} Z lclcallable�
lclcontextr r r r 2 s zTemplateNamespace.__init__c C s | j jS )z�The 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� rq )r r r r rq Q s zTemplateNamespace.modulec C s | j jS )zhThe path of the filesystem file used for this
:class:`.Namespace`'s module or template.
)r� r� )r r r r r� \ s zTemplateNamespace.filenamec C s | j jS )z�The 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 r r r r� c s zTemplateNamespace.uric # sX � j r&x � j D ]}|� j | fV qW � fdd�}x � jjjD ]}|||�fV q>W d S )Nc s � j �| �}t�|� j�S )N)r� �_get_def_callabler r ry )r' � callable_)r r r r1 s s z(TemplateNamespace._get_star.<locals>.get)r{ r� rq Z_exports)r r' r1 r� r )r r r� n s zTemplateNamespace._get_starc C st || j kr| j | }nN| j�|�r>| j�|�}t�|| j�}n&| jrRt| j|�}nt d| j
|f ��t | ||� |S )Nz!Namespace '%s' has no member '%s') r{ r� Zhas_defr� r r ry rr rI rs rx r� )r r' r� r� r r r rJ z s
z TemplateNamespace.__getattr__)NNNNTN) r? r@ rA rB r rC rq r� r� r� rJ r r r r r� . s
r� c @ s6 e Zd ZdZd dd�Zedd� �Zdd � Zd
d � ZdS )
�ModuleNamespacez;A :class:`.Namespace` specific to a Python module instance.NTc
C sf || _ || _|| _|d k r.tdd� |D ��| _t|�}x$|�d�dd � D ]} t|| �}qJW || _d S )Nc S s g | ]}|j |f�qS r )r? )rv r6 r r r rw � s z,ModuleNamespace.__init__.<locals>.<listcomp>�.ra ) rx ry rr rz r{ �
__import__�splitrI rq )
r rx ry rq r{ rr r| r} �mod�tokenr r r r � s
zModuleNamespace.__init__c C s | j jS )zhThe path of the filesystem file used for this
:class:`.Namespace`'s module or template.
)rq �__file__)r r r r r� � s zModuleNamespace.filenamec c sr | j r&x | j D ]}|| j | fV qW xFt| j�D ]8}|d dkr2t| j|�}t|�r2|t�|| j�fV q2W d S )Nr �_)r{ �dirrq rI �callabler r ry )r r' r� r r r r� � s zModuleNamespace._get_starc C st || j kr| j | }nNt| j|�r>t| j|�}t�|| j�}n&| jrRt| j|�}ntd| j |f ��t
| ||� |S )Nz!Namespace '%s' has no member '%s') r{ rp rq rI r r ry rr rs rx r� )r r' r� r� r r r rJ � s
zModuleNamespace.__getattr__)NNTN) r? r@ rA rB r rC r� r� rJ r r r r r� � s
r� c s � fdd�}|S )z�Apply a caller_stack compatibility decorator to a plain
Python function.
See the example in :ref:`namespaces_python_modules`.
c s, | j �� z� | f|�|�S | j �� X d S )N)r rL rM )ry �argsr )�funcr r �wrap_stackframe� s
z(supports_caller.<locals>.wrap_stackframer )r� r� r )r� r �supports_caller� s r� c O s< t |�st�d��| �� z|||� W d| �� }X |�� S )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))N)r� r r\ r/ r0 �getvalue)ry r� r� r r+ r r r r � s
r c s � fdd�}|S )Nc s �� fdd�}|S )Nc sL � �fdd�}y�j dd � |_ W n tk
r6 Y nX �|�� f|�|�S )Nc s �� f| �|�S )Nr )r� �kw)ry � render_fnr r �y� s zB_decorate_toplevel.<locals>.decorate_render.<locals>.go.<locals>.y� )r? r� )ry r� r� r� )�fnr� )ry r �go� s z7_decorate_toplevel.<locals>.decorate_render.<locals>.gor )r� r� )r� )r� r �decorate_render� s z+_decorate_toplevel.<locals>.decorate_renderr )r� r� r )r� r �_decorate_toplevel� s r� c s � �fdd�}|S )Nc s �| �� �� fdd�}|S )Nc s �� f| �|�S )Nr )r� r� )ry �decr r r� s z5_decorate_inline.<locals>.decorate_render.<locals>.gor )r� r� )ry r� )r� r r� � s z)_decorate_inline.<locals>.decorate_renderr )ry r� r� r )ry r� r �_decorate_inline� s r� c K s� t | ||�}t| �� |�\}}t|| jf|�}|jr~y||f|� W q� tk
rz |�|t�� �}|svtj t
� � � Y q�X n ||f|� dS )zPlocate the template from the given uri and include it in
the current output.N) r� r� r> �_kwargs_for_includer
Zinclude_error_handler� Exceptionr � exception_as�reraise�sys�exc_info)ry r� r} r r� r� �ctx�resultr r r r�
s r� c
C s� |dkr dS t | ||�}| d }|}x|jdk r8|j}q&W | �d|i�}td|j ||dd�|_|j | jd< |jd< t|jd d�}|dk r�|||�}|r�|S t|jd
d�} | dk r�| | � |j|fS ) z�called by the _inherit method in template modules to set
up the inheritance chain at the start of a template's
execution.Nr r< zself:%sF)r� r| r; �local�
_mako_inheritZ_mako_generate_namespaces) r� rr r: r� r� r
rI rq r� )
ry r� r} r� r� Zihr� r� �retZgen_nsr r r �
_inherit_from s.
r� c C sf | j j}|d kr"t�d| j j ��|�||�}y
|�|�S tjk
r` t�tt �
� ���Y nX d S )Nz.Template '%s' has no TemplateLookup associated) r
r r ZTemplateLookupExceptionr� Z
adjust_urir� ZTopLevelLookupException�strr r� )ry r� Z
relativetor r r r r� > s
r� c C s^ |d kr t d|j | |dd�}| | jd< | jd< t|jd�rT|j�|| �}|rT|S |j| fS )Nzself:%sF)r� r| r r� r� )r� r� r
rp rq r� r� )ry r� r� r� r r r r� L s r� Fc C sx |rt jdd�}n$| jr"t�� }nt j|| j| jd�}t|f|�}||_|� | � t
| ||f|�t ||�� |� � �
� S )z^create a Context and return the string
output of the given template and template callable.T)�
as_unicode)r� �encoding�errors)r r) Zbytestring_passthroughr �StringIO�output_encoding�encoding_errorsr r r �_render_context�_kwargs_for_callabler0 r� )r� r� r� r r� r+ ry r r r �_render\ s$
r� c C sn t �| �}|d r|S |d dd� |dd� D � }i }x0|D ](}|dkr>||kr>||kr>|| ||< q>W |S )Nri r c S s g | ]}|d k r|�qS )Nr )rv r� r r r rw s z(_kwargs_for_callable.<locals>.<listcomp>ra � ry )r �inspect_getargspec)r� r �argspec� namedargsr �argr r r r� x s
r� c K s^ t �| �}|d dd� |dd� D � }x0|D ](}|dkr.||kr.||kr.|| ||< q.W |S )Nr c S s g | ]}|d k r|�qS )Nr )rv r� r r r rw � s z'_kwargs_for_include.<locals>.<listcomp>ra r� ry )r r� )r� r r r� r� r� r r r r� � s
r� c O s\ dd l m} t| |j�s8t|| �\}}t||||d� n t|| j�\}}t||||d� d S )Nr )r� r )Z
mako.templater� �
isinstanceZ DefTemplater� �_exec_templater; )�tmplr� ry r� r r� Zinheritr� r r r r� � s r� c C s� |j }|dk rx|js|jrxy| |f|�|� W q� tk
rR t||t�� � Y q� t�� d }t|||� Y q�X n| |f|�|� dS )z�execute 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
Zformat_exceptions�
error_handlerr� �
_render_errorr r� r� r� )r� ry r� r r� �er r r r� � s r� c C s� | j r&| � ||�}|s�tjt�� � n\t�� }|jrNtj dd�g|j
d d �< n t� |j |j �g|j
d d �< |�
|� |j||d� d S )NT)r� )�error)r� r r� r� r� r Zhtml_error_templater r r) r r� r� r Zrender_context)r� ry r� r� Zerror_templater r r r� � s
r� )N)F)NN)$rB r r� �makor r r Z mako.compatr �objectr r$ r rN Z UNDEFINEDZSTOP_RENDERINGrR rZ rn ru r� r� r� r r� r� r� r� r� r� r� r� r� r� r� r� r r r r �<module> sB - (B D]: