3
sݨ\kl � @ s d Z ddlZddlmZ ddlmZ ddlmZmZ ddl m
Z
m Z m Z m
Z
mZmZmZmZmZ ddlmZmZmZ ddlmZmZmZmZm Z m Z m Z m Z d d
d d d
dddddddddgZ eZ!dd� Z"e#� Z$e#� Z%dd� Z&dd� Z'd7dd �Z(G d d
� d
e#�Z)d d � Z*G d d!� d!e+�Z,e
fd"d#�Z-G d$d%� d%e e,��Z.ydd&l/m0Z0 e0j1e.� W n e2k
�rf Y nX G d'd(� d(e#�Z3G d)d*� d*e#�Z4G d+d � d e4�Z5eG d,d-� d-e#��Z6G d.d � d e#�Z7e G d/d0� d0e#��Z8d8d1d2�Z9e G d3d4� d4e8��Z:e G d5d6� d6e8��Z;e8`<e:`<e;`<dS )9z}
jinja2.runtime
~~~~~~~~~~~~~~
Runtime helpers.
:copyright: (c) 2017 by the Jinja Team.
:license: BSD.
� N)�chain)�
MethodType)� EvalContext�_context_function_types) �Markup� soft_unicode�escape�missing�concat� internalcode�object_type_repr�evalcontextfunction� Namespace)�UndefinedError�TemplateRuntimeError�TemplateNotFound)�imap� text_type� iteritems�implements_iterator�implements_to_string� string_types�PY2�with_metaclass� LoopContext�TemplateReference�Macror r r r
r � markup_join� unicode_join� to_string�identityr r c C s | S )N� )�xr! r! � /usr/lib/python3.6/runtime.py�<lambda>% s r$ c C sL g }t t| �}x4|D ],}|j|� t|d�rtd�jt||��S qW t|�S )z@Concatenation that escapes if necessary and converts to unicode.Z__html__� )r r �append�hasattrr �joinr r
)�seqZbuf�iterator�argr! r! r# r + s
c C s t tt| ��S )z4Simple args to unicode conversion and concatenation.)r
r r )r) r! r! r# r 6 s c
C sl |dkr i }|r|}nt |p f f|�}|r\|r6t |�}x$t|�D ]\}} | tk r@| ||< q@W | j| |||�S )z(Internal helper to for context creation.N)�dictr r Z
context_class)
� environmentZ
template_name�blocks�varsZshared�globals�locals�parent�key�valuer! r! r# � new_context; s
r5 c @ s( e Zd ZdZdd� Zdd� Zdd� ZdS ) r zThe `self` in templates.c C s
|| _ d S )N)�_TemplateReference__context)�self�contextr! r! r# �__init__S s zTemplateReference.__init__c C s | j j| }t|| j |d�S )Nr )r6 r. �BlockReference)r7 �namer. r! r! r# � __getitem__V s z TemplateReference.__getitem__c C s d| j j| jjf S )Nz<%s %r>)� __class__�__name__r6 r; )r7 r! r! r# �__repr__Z s zTemplateReference.__repr__N)r> �
__module__� __qualname__�__doc__r9 r< r? r! r! r! r# r P s c C s t | d| �S )N�__func__)�getattr)r" r! r! r# � _get_funca s rE c @ s e Zd Zdd� ZdS )� ContextMetac C sv t j| |||�}|f kr |S t|j�}ttj�}t|j�}ttj�}||k r\||kr\d|_n||krr||krrd|_|S )NT)�type�__new__rE �resolve�Context�resolve_or_missing�_legacy_resolve_mode�_fast_resolve_mode) �clsr; �bases�d�rvrI Zdefault_resolverK Zdefault_resolve_or_missingr! r! r# rH g s
zContextMeta.__new__N)r> r@ rA rH r! r! r! r# rF e s rF c C s, || j kr| j | S || jkr(| j| S |S )N)r/ r2 )r8 r3 r r! r! r# rK } s
rK c @ s� e Zd ZdZdZdZdd� Zdd� Zd$dd �Zd
d � Z d d
� Z
dd� Z dd� Z e
dd� �Zd%dd�Zdd� Zed�Zed�Zed�Zer�ed�Zed �Zed �Z[d d � Zd d!� Zd"d#� ZdS )&rJ a� The template context holds the variables of a template. It stores the
values passed to the template and also the names the template exports.
Creating instances is neither supported nor useful as it's created
automatically at various stages of the template evaluation and should not
be created by hand.
The context is immutable. Modifications on :attr:`parent` **must not**
happen and modifications on :attr:`vars` are allowed from generated
template code only. Template filters and global functions marked as
:func:`contextfunction`\s get the active context passed as first argument
and are allowed to access the context read-only.
The template context supports read only dict operations (`get`,
`keys`, `values`, `items`, `iterkeys`, `itervalues`, `iteritems`,
`__getitem__`, `__contains__`). Additionally there is a :meth:`resolve`
method that doesn't fail with a `KeyError` but returns an
:class:`Undefined` object for missing variables.
Fc C s\ || _ i | _|| _t| j|�| _t� | _|| _tdd� t |�D ��| _
| j rXt t
| �| _
d S )Nc s s | ]\}}||gfV qd S )Nr! )�.0�k�vr! r! r# � <genexpr>� s z#Context.__init__.<locals>.<genexpr>)r2 r/ r- r �eval_ctx�set�
exported_varsr; r, r r. rM r rK )r7 r- r2 r; r. r! r! r# r9 � s zContext.__init__c
C sX y$| j | }|j|�d }|| W n$ tk
rH | jjd| dd�S X t|| ||�S )zRender a parent block.� z#there is no parent block called %r.�super)r; )r. �index� LookupErrorr- � undefinedr: )r7 r; Zcurrentr. r[ r! r! r# rZ � s
z
Context.superNc C s" y| | S t k
r |S X dS )zfReturns an item from the template context, if it doesn't exist
`default` is returned.
N)�KeyError)r7 r3 �defaultr! r! r# �get� s z Context.getc C s6 | j rt| |�}n
| j|�}|tkr2| jj|d�S |S )z�Looks up a variable like `__getitem__` or `get` but returns an
:class:`Undefined` object with the name of the name looked up.
)r; )rL rK r r- r] )r7 r3 rQ r! r! r# rI � s
zContext.resolvec C s, | j r"| j|�}t|t�r t}|S t| |�S )zxResolves a variable like :meth:`resolve` but returns the
special `missing` value if it cannot be found.
)rL rI �
isinstance� Undefinedr rK )r7 r3 rQ r! r! r# rK � s
zContext.resolve_or_missingc s t � fdd�� jD ��S )z+Get a new dict with the exported variables.c 3 s | ]}|� j | fV qd S )N)r/ )rR rS )r7 r! r# rU � s z'Context.get_exported.<locals>.<genexpr>)r, rX )r7 r! )r7 r# � get_exported� s zContext.get_exportedc C s( | j s | jS | js| j S t| jf| j �S )z�Return the complete context as dict including the exported
variables. For optimizations reasons this might not return an
actual copy so be careful with using it.
)r/ r2 r, )r7 r! r! r# �get_all� s
zContext.get_allc O s� t |d�r.|j}x dD ]}t ||�r|}P qW t|t�r�t|dd�rP| f| }n2t|dd�rj| jf| }nt|dd�r�| jf| }y
|||�S tk
r� | jjd�S X dS ) z�Call the callable with the arguments and keyword arguments
provided but inject the active context or environment as first
argument if the callable is a :func:`contextfunction` or
:func:`environmentfunction`.
�__call__�contextfunctionr
�environmentfunctionr zGvalue was undefined because a callable raised a StopIteration exceptionN)rf r
rg ) r' re ra r rD rV r- �
StopIterationr] )Z_Context__selfZ
_Context__obj�args�kwargs�fnZfn_typer! r! r# �call� s&
z Context.callc C sD t | j| ji | j� dd|�}| j|_|jjdd� t| j�D �� |S )z�Internal helper function to create a derived context. This is
used in situations where the system needs a new context in the same
template that is independent.
TNc s s | ]\}}|t |�fV qd S )N)�list)rR rS rT r! r! r# rU s z"Context.derived.<locals>.<genexpr>)r5 r- r; rd rV r. �updater )r7 r1 r8 r! r! r# �derived s
zContext.derivedc s$ � fdd�}t t� �j|_� |_|S )Nc s t | j� � �� S )N)rD rd )r7 )�methr! r# r$ s z Context._all.<locals>.<lambda>)rD r, rB r> )rp �proxyr! )rp r# �_all s z Context._all�keys�values�items�iterkeys�
itervaluesr c C s || j kp|| jkS )N)r/ r2 )r7 r; r! r! r# � __contains__( s zContext.__contains__c C s | j |�}|tkrt|��|S )zTLookup a variable or raise `KeyError` if the variable is
undefined.
)rK r r^ )r7 r3 �itemr! r! r# r< + s
zContext.__getitem__c C s d| j jt| j� �| jf S )Nz
<%s %s of %r>)r= r> �reprrd r; )r7 r! r! r# r? 4 s
zContext.__repr__)N)N)r> r@ rA rB rL rM r9 rZ r` rI rK rc rd r rl ro rr rs rt ru r rv rw r rx r< r? r! r! r! r# rJ � s0
"
rJ )�Mappingc @ s0 e Zd ZdZdd� Zedd� �Zedd� �ZdS ) r: z"One block on a template reference.c C s || _ || _|| _|| _d S )N)r; �_context�_stack�_depth)r7 r; r8 �stack�depthr! r! r# r9 G s zBlockReference.__init__c C sF | j d t| j�kr,| jjjd| j dd�S t| j| j| j| j d �S )zSuper the block.rY z#there is no parent block called %r.rZ )r; )r~ �lenr} r| r- r] r; r: )r7 r! r! r# rZ M s zBlockReference.superc C s, t | j| j | j��}| jjjr(t|�}|S )N)r
r} r~ r| rV �
autoescaper )r7 rQ r! r! r# re W s
zBlockReference.__call__N) r> r@ rA rB r9 �propertyrZ r re r! r! r! r# r: D s
r: c @ s� e Zd ZdZeZeZeZdZ ddd�Z
dd� Z dd � Z e
d
d � �Ze
d d � �Ze
d
d � �Ze
dd � �Ze
dd � �Ze
dd � �Ze
dd� �Ze
dd� �Zdd� Zedd� �ZeZ[dd� ZdS ) �LoopContextBasez%A loop context for dynamic iteration.Nr c C s" || _ || _d| _|| _t| _d S )NrY ���)�
_undefined�_recurse�index0�depth0r �_last_checked_value)r7 r] �recurser� r! r! r# r9 g s
zLoopContextBase.__init__c G s |s t d��|| jt|� S )z7Cycles among the arguments with the current loop index.zno items for cycling given)� TypeErrorr� r� )r7 ri r! r! r# �cyclen s zLoopContextBase.cyclec G s | j |kr|| _ dS dS )z9Checks whether the value has changed since the last call.TF)r� )r7 r4 r! r! r# �changedt s
zLoopContextBase.changedc C s
| j dkS )Nr )r� )r" r! r! r# r$ { s zLoopContextBase.<lambda>c C s
| j tkS )N)�_after�_last_iteration)r" r! r! r# r$ | s c C s
| j d S )NrY )r� )r" r! r! r# r$ } s c C s | j | j S )N)�lengthr� )r" r! r! r# r$ ~ s c C s | j | j S )N)r� r[ )r" r! r! r# r$ s c C s
| j d S )NrY )r� )r" r! r! r# r$ � s c C s | j tkr| jd�S | j S )Nzthere is no previous item)�_before�_first_iterationr� )r7 r! r! r# �previtem� s
zLoopContextBase.previtemc C s | j tkr| jd�S | j S )Nzthere is no next item)r� r� r� )r7 r! r! r# �nextitem� s
zLoopContextBase.nextitemc C s | j S )N)r� )r7 r! r! r# �__len__� s zLoopContextBase.__len__c C s( | j d krtd��| j || j | jd �S )NzMTried to call non recursive loop. Maybe you forgot the 'recursive' modifier.rY )r� r� r� )r7 �iterabler! r! r# �loop� s
zLoopContextBase.loopc C s d| j j| j| jf S )Nz
<%s %r/%r>)r= r> r[ r� )r7 r! r! r# r? � s zLoopContextBase.__repr__)Nr )r> r@ rA rB r� r� �_currentr� r� �_lengthr9 r� r� r� �firstZlastr[ ZrevindexZ revindex0r� r� r� r� r r� re r? r! r! r! r# r� _ s*
r� c @ s2 e Zd Zd dd�Zedd� �Zdd� Zd d
� ZdS ) r Nr c C sV t j| |||� t|�| _yt|�| _W n ttfk
rF d | _Y nX | j� | _ d S )N)
r� r9 �iter� _iteratorr� r� r� �AttributeError�
_safe_nextr� )r7 r� r] r� r� r! r! r# r9 � s
zLoopContext.__init__c C s< | j d kr6t| j�}t|�| _| jd }t|�| | _ | j S )N� )r� �tupler� r� r� r� )r7 r� Ziterations_doner! r! r# r� � s
zLoopContext.lengthc C s t | �S )N)�LoopContextIterator)r7 r! r! r# �__iter__� s zLoopContext.__iter__c C s$ y
t | j�S tk
r tS X d S )N)�nextr� rh r� )r7 r! r! r# r� � s
zLoopContext._safe_next)Nr )r> r@ rA r9 r� r� r� r� r! r! r! r# r � s
c @ s, e Zd ZdZd
Zdd� Zdd� Zdd� Zd S ) r� z The iterator for a loop context.r8 c C s
|| _ d S )N)r8 )r7 r8 r! r! r# r9 � s z LoopContextIterator.__init__c C s | S )Nr! )r7 r! r! r# r� � s z LoopContextIterator.__iter__c C sH | j }| jd7 _|jtkr$t� �|j|_|j|_|j� |_|j|fS )NrY )r8 r� r� r� rh r� r� r� )r7 Zctxr! r! r# �__next__� s
z LoopContextIterator.__next__N)r8 )r> r@ rA rB � __slots__r9 r� r� r! r! r! r# r� � s
r� c @ s: e Zd ZdZd dd�Zeedd� ��Zdd� Zd d
� Z dS ) r zWraps a macro function.Nc C sV || _ || _t|�| _|| _|| _|| _|| _|| _d|k| _ |d krL|j
}|| _ d S )N�caller) � _environment�_funcr� �_argument_countr; � arguments� catch_kwargs�
catch_varargsr� �explicit_callerr� �_default_autoescape) r7 r- �funcr; r� r� r� r� Zdefault_autoescaper! r! r# r9 � s
zMacro.__init__c O s� |r*t |d t�r*|d j}|dd � }n| j}t|d | j� �}t|�}d}|| jkr�xht| jt|�d � �D ]F\}}y|j |�} W n t
k
r� t } Y nX |dkr�d}|j | � qpW n| j
}| jr�| r�|j dd �}
|
d kr�| jjddd�}
|j |
� | j�r|j |� n8|�rHd|k�r.td| j ��td | jtt|��f ��| j�rf|j || jd � � n(t|�| jk�r�td
| jt| j�f ��| j||�S ) Nr rY Fr� TzNo caller defined)r; zamacro %r was invoked with two values for the special caller argument. This is most likely a bug.z%macro %r takes no keyword argument %rz+macro %r takes not more than %d argument(s))ra r r� r� rm r� r� � enumerater� �popr^ r r& r� r� r� r] r� r� r; r� r� r� �_invoke) r7 ri rj r� r� ZoffZ found_caller�idxr; r4 r� r! r! r# re � sJ
zMacro.__call__c C s | j |� }|rt|�}|S )z=This method is being swapped out by the async implementation.)r� r )r7 r� r� rQ r! r! r# r� A s
z
Macro._invokec C s$ d| j j| jd krdp t| j�f S )Nz<%s %s>Z anonymous)r= r> r; rz )r7 r! r! r# r? H s zMacro.__repr__)N)
r> r@ rA rB r9 r r
re r� r? r! r! r! r# r � s
Kc @ s� e Zd ZdZd Zdedefdd�Zed d
� �Z ed d � �Z
e Z Z Z
Z Z Z Z Z Z Z Z Z Z Z Z Z Z Z Z Z Z Z Z! Z" Z# Z$Z%d
d� Z&dd� Z'dd� Z(dd� Z)dd� Z*dd� Z+dd� Z,e,Z-dd � Z.dS ) rb az The default undefined type. This undefined type can be printed and
iterated over, but every other access will raise an :exc:`jinja2.exceptions.UndefinedError`:
>>> foo = Undefined(name='foo')
>>> str(foo)
''
>>> not foo
True
>>> foo + 42
Traceback (most recent call last):
...
jinja2.exceptions.UndefinedError: 'foo' is undefined
�_undefined_hint�_undefined_obj�_undefined_name�_undefined_exceptionNc C s || _ || _|| _|| _d S )N)r� r� r� r� )r7 �hint�objr; �excr! r! r# r9 a s zUndefined.__init__c O sl | j dkrX| jtkr d| j }q^t| jt�sBdt| j�| jf }q^dt| j�| jf }n| j }| j|��dS )z{Regular callback function for undefined objects that raises an
`jinja2.exceptions.UndefinedError` on call.
Nz%r is undefinedz%s has no element %rz%r has no attribute %r)r� r� r r� ra r r r� )r7 ri rj r� r! r! r# �_fail_with_undefined_errorg s
z$Undefined._fail_with_undefined_errorc C s |d d� dkrt |��| j� S )Nr� �__)r� r� )r7 r; r! r! r# � __getattr__} s zUndefined.__getattr__c C s t | �t |�kS )N)rG )r7 �otherr! r! r# �__eq__� s zUndefined.__eq__c C s | j |� S )N)r� )r7 r� r! r! r# �__ne__� s zUndefined.__ne__c C s t t| ��S )N)�idrG )r7 r! r! r# �__hash__� s zUndefined.__hash__c C s dS )Nr% r! )r7 r! r! r# �__str__� s zUndefined.__str__c C s dS )Nr r! )r7 r! r! r# r� � s zUndefined.__len__c c s d S )Nr! )r7 r! r! r# r� � s zUndefined.__iter__c C s dS )NFr! )r7 r! r! r# � __nonzero__� s zUndefined.__nonzero__c C s dS )Nrb r! )r7 r! r! r# r? � s zUndefined.__repr__)r� r� r� r� )/r> r@ rA rB r� r r r9 r r� r� �__add__�__radd__�__mul__�__rmul__Z__div__Z__rdiv__� __truediv__� __rtruediv__� __floordiv__�
__rfloordiv__�__mod__�__rmod__�__pos__�__neg__re r< �__lt__�__le__�__gt__�__ge__�__int__� __float__� __complex__�__pow__�__rpow__�__sub__�__rsub__r� r� r� r� r� r� r� �__bool__r? r! r! r! r# rb O s lrb c s` �dkr,ddl }|jt���j|jtj�� �dkr8t��fdd�� G � ��fdd�d��}|S )ak Given a logger object this returns a new undefined class that will
log certain failures. It will log iterations and printing. If no
logger is given a default logger is created.
Example::
logger = logging.getLogger(__name__)
LoggingUndefined = make_logging_undefined(
logger=logger,
base=Undefined
)
.. versionadded:: 2.8
:param logger: the logger to use. If not provided, a default logger
is created.
:param base: the base class to add logging functionality to. This
defaults to :class:`Undefined`.
Nr c sn | j d krX| jtkr d| j }q^t| jt�sBdt| j�| jf }q^dt| j�| jf }n| j }� jd|� d S )Nz%s is undefinedz%s has no element %sz%s has no attribute %sz Template variable warning: %s)r� r� r r� ra r r Zwarning)Zundefr� )�loggerr! r# � _log_message� s
z,make_logging_undefined.<locals>._log_messagec sf e Zd Z��fdd�Z� �fdd�Z� �fdd�ZerT� �fdd�Z� �fd d
�Zn� �fd d �Z d
S )z0make_logging_undefined.<locals>.LoggingUndefinedc sP y� j | f|�|�S | jk
rJ } z�jdt|�� |�W Y d d }~X nX d S )NzTemplate variable error: %s)r� r� �error�str)r7 ri rj �e)�baser� r! r# r� � s
zKmake_logging_undefined.<locals>.LoggingUndefined._fail_with_undefined_errorc s �j | �}� | � |S )N)r� )r7 rQ )r� r� r! r# r� � s
z8make_logging_undefined.<locals>.LoggingUndefined.__str__c s �j | �}� | � |S )N)r� )r7 rQ )r� r� r! r# r� � s
z9make_logging_undefined.<locals>.LoggingUndefined.__iter__c s �j | �}� | � |S )N)r� )r7 rQ )r� r� r! r# r� � s
z<make_logging_undefined.<locals>.LoggingUndefined.__nonzero__c s �j | �}� | � |S )N)� __unicode__)r7 rQ )r� r� r! r# r� � s
z<make_logging_undefined.<locals>.LoggingUndefined.__unicode__c s �j | �}� | � |S )N)r� )r7 rQ )r� r� r! r# r� � s
z9make_logging_undefined.<locals>.LoggingUndefined.__bool__N)
r> r@ rA r� r� r� r r� r� r� r! )r� r� r� r! r# �LoggingUndefined� s r� )�loggingZ getLoggerr> Z
addHandlerZ
StreamHandler�sys�stderrrb )r� r� r� r� r! )r� r� r� r# �make_logging_undefined� s
#r� c @ s e Zd ZdZf Zdd� ZdS )�DebugUndefineda An undefined that returns the debug info when printed.
>>> foo = DebugUndefined(name='foo')
>>> str(foo)
'{{ foo }}'
>>> not foo
True
>>> foo + 42
Traceback (most recent call last):
...
jinja2.exceptions.UndefinedError: 'foo' is undefined
c C s< | j d kr2| jtkr d| j S dt| j�| jf S d| j S )Nz{{ %s }}z {{ no such element: %s[%r] }}z!{{ undefined value printed: %s }})r� r� r r� r )r7 r! r! r# r� s
zDebugUndefined.__str__N)r> r@ rA rB r� r� r! r! r! r# r� � s
r� c @ s6 e Zd ZdZf Zej Z Z Z Z
Z Z Z
ZdS )�StrictUndefinedas An undefined that barks on print and iteration as well as boolean
tests and all kinds of comparisons. In other words: you can do nothing
with it except checking if it's defined using the `defined` test.
>>> foo = StrictUndefined(name='foo')
>>> str(foo)
Traceback (most recent call last):
...
jinja2.exceptions.UndefinedError: 'foo' is undefined
>>> not foo
Traceback (most recent call last):
...
jinja2.exceptions.UndefinedError: 'foo' is undefined
>>> foo + 42
Traceback (most recent call last):
...
jinja2.exceptions.UndefinedError: 'foo' is undefined
N)r> r@ rA rB r� rb r� r� r� r� r� r� r� r� r� r! r! r! r# r� s r� )NNNN)NN)=rB r� � itertoolsr �typesr Z jinja2.nodesr r Z jinja2.utilsr r r r r
r r r
r Zjinja2.exceptionsr r r Zjinja2._compatr r r r r r r r �__all__r r �objectr� r� r r r5 r rE rG rF rK rJ � collectionsr{ �register� ImportErrorr: r� r r� r rb r� r� r� r� r! r! r! r# �<module>
sX ,(
9 F' m U
Q