|
Server : Apache System : Linux cvar2.toservers.com 3.10.0-962.3.2.lve1.5.73.el7.x86_64 #1 SMP Wed Aug 24 21:31:23 UTC 2022 x86_64 User : njnconst ( 1116) PHP Version : 8.4.18 Disable Function : NONE Directory : /usr/lib/python2.7/site-packages/jinja2/ |
Upload File : |
�
-/�_c @ s� d Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d d l m Z d d l m
Z
d d l m Z d d l m Z d d
l m
Z
d d l m Z d d l m Z d d
l m Z d � Z d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d S(! sK API and implementations for loading templates from different data
sources.
i����N( t sha1( t path( t
ModuleTypei ( t abc( t fspath( t iteritems( t string_types( t TemplateNotFound( t internalcode( t open_if_existsc C s� g } x~ | j d � D]m } t j | k sR t j rC t j | k sR | t j k ra t | � � q | r | d k r | j | � q q W| S( s� Split a path into segments and perform a sanity check. If it detects
'..' in the path it will raise a `TemplateNotFound` error.
t /t .( t splitR t sept altsept pardirR t append( t templatet piecest piece( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyt split_template_path s t
BaseLoaderc B s8 e Z d Z e Z d � Z d � Z e d d � � Z RS( s� Baseclass for all loaders. Subclass this and override `get_source` to
implement a custom loading mechanism. The environment provides a
`get_template` method that calls the loader's `load` method to get the
:class:`Template` object.
A very basic example for a loader that looks up templates on the file
system could look like this::
from jinja2 import BaseLoader, TemplateNotFound
from os.path import join, exists, getmtime
class MyLoader(BaseLoader):
def __init__(self, path):
self.path = path
def get_source(self, environment, template):
path = join(self.path, template)
if not exists(path):
raise TemplateNotFound(template)
mtime = getmtime(path)
with file(path) as f:
source = f.read().decode('utf-8')
return source, path, lambda: mtime == getmtime(path)
c C s2 | j s" t d | j j � � n t | � � d S( s� Get the template source, filename and reload helper for a template.
It's passed the environment and template name and has to return a
tuple in the form ``(source, filename, uptodate)`` or raise a
`TemplateNotFound` error if it can't locate the template.
The source part of the returned tuple must be the source of the
template as unicode string or a ASCII bytestring. The filename should
be the name of the file on the filesystem if it was loaded from there,
otherwise `None`. The filename is used by python for the tracebacks
if no loader extension is used.
The last item in the tuple is the `uptodate` function. If auto
reloading is enabled it's always called to check if the template
changed. No arguments are passed so the function must store the
old state somewhere (for example in a closure). If it returns `False`
the template will be reloaded.
s& %s cannot provide access to the sourceN( t has_source_accesst RuntimeErrort __class__t __name__R ( t selft environmentR ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyt
get_sourceG s c C s t d � � d S( s� Iterates over all templates. If the loader does not support that
it should raise a :exc:`TypeError` which is the default behavior.
s- this loader cannot iterate over all templatesN( t TypeError( R ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyt list_templates_ s c
C s� d } | d k r i } n | j | | � \ } } } | j } | d k ro | j | | | | � } | j } n | d k r� | j | | | � } n | d k r� | j d k r� | | _ | j | � n | j j | | | | � S( sc Loads a template. This method looks up the template in the cache
or loads one by calling :meth:`get_source`. Subclasses should not
override this method as loaders working on collections of other
loaders (such as :class:`PrefixLoader` or :class:`ChoiceLoader`)
will not call this method but `get_source` directly.
N( t NoneR t bytecode_cachet
get_buckett codet compilet
set_buckett template_classt from_code(
R R t namet globalsR" t sourcet filenamet uptodatet bcct bucket( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyt loade s N(
R t
__module__t __doc__t TrueR R R R R R. ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR & s t FileSystemLoaderc B s/ e Z d Z d e d � Z d � Z d � Z RS( s# Loads templates from the file system. This loader can find templates
in folders on the file system and is the preferred way to load them.
The loader takes the path to the templates as string, or if multiple
locations are wanted a list of them which is then looked up in the
given order::
>>> loader = FileSystemLoader('/path/to/templates')
>>> loader = FileSystemLoader(['/path/to/templates', '/other/path'])
Per default the template encoding is ``'utf-8'`` which can be changed
by setting the `encoding` parameter to something else.
To follow symbolic links, set the *followlinks* parameter to ``True``::
>>> loader = FileSystemLoader('/path/to/templates', followlinks=True)
.. versionchanged:: 2.8
The ``followlinks`` parameter was added.
s utf-8c C sf t | t j � s" t | t � r. | g } n g | D] } t | � ^ q5 | _ | | _ | | _ d S( N( t
isinstanceR t IterableR R t
searchpatht encodingt followlinks( R R5 R6 R7 t p( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyt __init__� s " c s� t | � } x� | j D]� } t j | | � � t � � } | d k rL q n z | j � j | j � } Wd | j � Xt j
� � � � � f d � } | � | f SWt | � � d S( Nc s0 y t j � � � k SWn t k
r+ t SXd S( N( R t getmtimet OSErrort False( ( R* t mtime( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR+ � s
( R R5 R t joinR R t readt decodeR6 t closeR: R ( R R R R R5 t ft contentsR+ ( ( R* R= s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR � s c C s� t � } x� | j D]� } t j | d | j �} x� | D]� \ } } } x� | D] } t j j | | � t | � j t j j � j
t j j d � } | d d k r� | d } n | | k rN | j | � qN qN Wq8 Wq Wt | � S( NR7 R
i s ./(
t setR5 t ost walkR7 R R> t lent stripR
t replacet addt sorted( R t foundR5 t walk_dirt dirpatht _t filenamesR* R ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR � s
( R R/ R0 R< R9 R R ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR2 � s
t
PackageLoaderc B s/ e Z d Z d d d � Z d � Z d � Z RS( s, Load templates from python eggs or packages. It is constructed with
the name of the python package and the path to the templates in that
package::
loader = PackageLoader('mypackage', 'views')
If the package path is not given, ``'templates'`` is assumed.
Per default the template encoding is ``'utf-8'`` which can be changed
by setting the `encoding` parameter to something else. Due to the nature
of eggs it's only possible to reload templates if the package was loaded
from the file system and not a zip file.
t templatess utf-8c C sy d d l m } d d l m } d d l m } | | � } | | _ | � | _ t | | � | _ | | _ | | _ d S( Ni����( t DefaultProvider( t get_provider( t ResourceManager(
t
pkg_resourcesRS RT RU R6 t managerR3 t filesystem_boundt providert package_path( R t package_nameRZ R6 RS RT RU RY ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR9 � s c s� t | � } d j | j f t | � � } | j j | � sL t | � � n d � } | j r� | j j | j
| � � t j � � � � � f d � } n | j j
| j
| � } | j | j � � | f S( NR
c s0 y t j � � � k SWn t k
r+ t SXd S( N( R R: R; R< ( ( R* R= ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR+ s
( R R> RZ t tupleRY t has_resourceR R RX t get_resource_filenameRW R R: t get_resource_stringR@ R6 ( R R R R R8 R+ R) ( ( R* R= s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR � s
c s} � j } | d d k r& | d } n | d k r; d } n t | � � g � � � � � f d � � � | � � j � � S( Ni s ./R t c sh xa � j j | � D]M } | d | } � j j | � rF � | � q � j | � j d � � q Wd S( NR
( RY t resource_listdirt resource_isdirR t lstrip( R R* t fullname( t _walkt offsett resultsR ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyRe s
( RZ RG t sort( R R ( ( Re Rf Rg R s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR
s
( R R/ R0 R9 R R ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyRQ � s
t
DictLoaderc B s) e Z d Z d � Z d � Z d � Z RS( s Loads a template from a python dict. It's passed a dict of unicode
strings bound to template names. This loader is useful for unittesting:
>>> loader = DictLoader({'index.html': 'source here'})
Because auto reloading is rarely useful this is disabled per default.
c C s
| | _ d S( N( t mapping( R Rj ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR9 , s c sH � � j k r8 � j � � � d � � � f d � f St � � � d S( Nc s � � j j � � k S( N( Rj t get( ( R R) R ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyt <lambda>2 s ( Rj R R ( R R R ( ( R R) R s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR / s
c C s
t | j � S( N( RK Rj ( R ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR 5 s ( R R/ R0 R9 R R ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyRi # s t FunctionLoaderc B s e Z d Z d � Z d � Z RS( s� A loader that is passed a function which does the loading. The
function receives the name of the template and has to return either
an unicode string with the template source, a tuple in the form ``(source,
filename, uptodatefunc)`` or `None` if the template does not exist.
>>> def load_template(name):
... if name == 'index.html':
... return '...'
...
>>> loader = FunctionLoader(load_template)
The `uptodatefunc` is a function that is called if autoreload is enabled
and has to return `True` if the template is still up to date. For more
details have a look at :meth:`BaseLoader.get_source` which has the same
return value.
c C s
| | _ d S( N( t load_func( R Rn ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR9 K s c C sJ | j | � } | d k r* t | � � n t | t � rF | d d f S| S( N( Rn R R R3 R ( R R R t rv( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR N s
( R R/ R0 R9 R ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyRm 9 s t PrefixLoaderc B sG e Z d Z d d � Z d � Z d � Z e d d � � Z d � Z RS( s A loader that is passed a dict of loaders where each loader is bound
to a prefix. The prefix is delimited from the template by a slash per
default, which can be changed by setting the `delimiter` argument to
something else::
loader = PrefixLoader({
'app1': PackageLoader('mypackage.app1'),
'app2': PackageLoader('mypackage.app2')
})
By loading ``'app1/index.html'`` the file from the app1 package is loaded,
by loading ``'app2/index.html'`` the file from the second.
R
c C s | | _ | | _ d S( N( Rj t delimiter( R Rj Rq ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR9 f s c C s\ y, | j | j d � \ } } | j | } Wn# t t f k
rQ t | � � n X| | f S( Ni ( R Rq Rj t
ValueErrort KeyErrorR ( R R t prefixR' t loader( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyt
get_loaderj s c C sM | j | � \ } } y | j | | � SWn t k
rH t | � � n Xd S( N( Rv R R ( R R R Ru R' ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR r s
c C sP | j | � \ } } y | j | | | � SWn t k
rK t | � � n Xd S( N( Rv R. R ( R R R' R( Ru t
local_name( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR. { s
c C sY g } xL t | j � D]; \ } } x, | j � D] } | j | | j | � q/ Wq W| S( N( R Rj R R Rq ( R t resultRt Ru R ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR � s
N(
R R/ R0 R9 Rv R R R R. R ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyRp W s
t ChoiceLoaderc B s; e Z d Z d � Z d � Z e d d � � Z d � Z RS( s� This loader works like the `PrefixLoader` just that no prefix is
specified. If a template could not be found by one loader the next one
is tried.
>>> loader = ChoiceLoader([
... FileSystemLoader('/path/to/user/templates'),
... FileSystemLoader('/path/to/system/templates')
... ])
This is useful if you want to allow users to override builtin templates
from a different location.
c C s
| | _ d S( N( t loaders( R Rz ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR9 � s c C sL x9 | j D]. } y | j | | � SWq
t k
r7 q
Xq
Wt | � � d S( N( Rz R R ( R R R Ru ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR � s
c C sO x< | j D]1 } y | j | | | � SWq
t k
r: q
Xq
Wt | � � d S( N( Rz R. R ( R R R' R( Ru ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR. � s
c C s: t � } x$ | j D] } | j | j � � q Wt | � S( N( RD Rz t updateR RK ( R RL Ru ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR � s N( R R/ R0 R9 R R R R. R ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyRy � s t _TemplateModulec B s e Z d Z RS( s9 Like a normal module but with support for weak references( R R/ R0 ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR| � s t ModuleLoaderc B sM e Z d Z e Z d � Z e d � � Z e d � � Z e d d � � Z RS( s6 This loader loads templates from precompiled templates.
Example usage:
>>> loader = ChoiceLoader([
... ModuleLoader('/path/to/compiled/templates'),
... FileSystemLoader('/path/to/templates')
... ])
Templates can be precompiled with :meth:`Environment.compile_templates`.
c s� d t | � � t � � } t | t j � s> t | t � rJ | g } n g | D] } t | � ^ qQ | _ t j | � f d � � t
j � <| | _ � | _
d S( Ns _jinja2_module_templates_%xc s t j j � d � S( N( t syst modulest popR ( t x( R[ ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyRl � s ( t idR| R3 R R4 R R t __path__t weakreft proxyR~ R t moduleR[ ( R R t modR8 ( ( R[ s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR9 � s " " c C s d t | j d � � j � S( Nt tmpl_s utf-8( R t encodet hexdigest( R' ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyt get_template_key� s c C s t j | � d S( Ns .py( R} R� ( R' ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyt get_module_filename� s c C s� | j | � } d | j | f } t | j | d � } | d k r� y t | d d d g � } Wn t k
r~ t | � � n Xt j j
| d � n | j j | | j
| � S( Ns %s.%st root( R� R[ t getattrR� R t
__import__t ImportErrorR R~ R R� R% t from_module_dictt __dict__( R R R' R( t keyR� R� ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR. � s
N( R R/ R0 R< R R9 t staticmethodR� R� R R R. ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyR} � s ( R0 RE R~ R� t hashlibR R t typesR t _compatR R R R t
exceptionsR t utilsR R R t objectR R2 RQ Ri Rm Rp Ry R| R} ( ( ( s0 /tmp/pip-install-sTXtzD/Jinja2/jinja2/loaders.pyt <module> s. gLJ 6)