| Current File : //usr/lib/python2.7/site-packages/jinja2/loaders.pyo |
�
��Rc @ si 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 m
Z
d d l m Z 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( s�
jinja2.loaders
~~~~~~~~~~~~~~
Jinja loader classes.
:copyright: (c) 2010 by the Jinja Team.
:license: BSD, see LICENSE for more details.
i����N( t
ModuleType( t path( t sha1( t TemplateNotFound( t open_if_existst internalcode( t string_typest iteritemsc 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( ( s2 /usr/lib/python2.7/site-packages/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 ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyt
get_sourceF 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 ( ( s2 /usr/lib/python2.7/site-packages/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( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyt loadc s N(
R t
__module__t __doc__t TrueR R R R R R, ( ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR % s t FileSystemLoaderc B s, e Z d Z d 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.
s utf-8c C s7 t | t � r | g } n t | � | _ | | _ d S( N( t
isinstanceR t listt
searchpatht encoding( R R3 R4 ( ( s2 /usr/lib/python2.7/site-packages/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( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR) � s
( R R3 R t joinR R t readt decodeR4 t closeR6 R ( R R R R R3 t ft contentsR) ( ( R( R9 s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR � s c C s� t � } x� | j D]� } x� t j | � D]� \ } } } x� | D] } t j j | | � t | � j t j j � j t j j d � } | d d k r� | d } n | | k r? | j
| � q? q? Wq) Wq Wt | � S( NR i s ./( t setR3 t ost walkR R: t lent stripR t replacet addt sorted( R t foundR3 t dirpatht dirnamest filenamesR( R ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR � s
( R R- R. R5 R R ( ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR0 � 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 se d d l m } m } m } | | � } | | _ | � | _ t | | � | _ | | _ | | _ d S( Ni����( t DefaultProvidert ResourceManagert get_provider(
t
pkg_resourcesRN RO RP R4 t managerR1 t filesystem_boundt providert package_path( R t package_nameRU R4 RN RO RP RT ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR5 � 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 R6 R7 R8 ( ( R( R9 ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR) � s
( R R: RU t tupleRT t has_resourceR R RS t get_resource_filenameRR R R6 t get_resource_stringR< R4 ( R R R R t pR) R' ( ( R( R9 s2 /usr/lib/python2.7/site-packages/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 ( RT t resource_listdirt resource_isdirR t lstrip( R R( t fullname( t _walkt offsett resultsR ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyRa � s
( RU RC t sort( R R ( ( Ra Rb Rc R s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR � s
( R R- R. R5 R R ( ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyRL � 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 Rf ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR5
s c sH � � j k r8 � j � � � d � � � f d � f St � � � d S( Nc s � � j j � � k S( N( Rf t get( ( R R' R ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyt <lambda> s ( Rf R R ( R R R ( ( R R' R s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR s
c C s
t | j � S( N( RG Rf ( R ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR s ( R R- R. R5 R R ( ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyRe 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 becomes the name of the template passed 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 Rj ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR5 , s c C sJ | j | � } | d k r* t | � � n t | t � rF | d d f S| S( N( Rj R R R1 R ( R R R t rv( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR / s
( R R- R. R5 R ( ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyRi 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( Rf t delimiter( R Rf Rm ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR5 G s c C s\ y, | j | j d � \ } } | j | } Wn# t t f k
rQ t | � � n X| | f S( Ni ( R
Rm Rf t
ValueErrort KeyErrorR ( R R t prefixR% t loader( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyt
get_loaderK s c C sM | j | � \ } } y | j | | � SWn t k
rH t | � � n Xd S( N( Rr R R ( R R R Rq R% ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR S s
c C sP | j | � \ } } y | j | | | � SWn t k
rK t | � � n Xd S( N( Rr R, R ( R R R% R& Rq t
local_name( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR, \ s
c C sY g } xL t | j � D]; \ } } x, | j � D] } | j | | j | � q/ Wq W| S( N( R Rf R R Rm ( R t resultRp Rq R ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR f s
N(
R R- R. R5 Rr R R R R, R ( ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyRl 8 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 Rv ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR5 | s c C sL x9 | j D]. } y | j | | � SWq
t k
r7 q
Xq
Wt | � � d S( N( Rv R R ( R R R Rq ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR s
c C sO x< | j D]1 } y | j | | | � SWq
t k
r: q
Xq
Wt | � � d S( N( Rv R, R ( R R R% R& Rq ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR, � s
c C s: t � } x$ | j D] } | j | j � � q Wt | � S( N( R@ Rv t updateR RG ( R RH Rq ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR � s N( R R- R. R5 R R R R, R ( ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyRu n s t _TemplateModulec B s e Z d Z RS( s9 Like a normal module but with support for weak references( R R- R. ( ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyRx � 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 � r7 | g } n t | � } | | _ 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( RV ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyRh � s ( t idRx R1 R R2 t __path__t weakreft proxyRz R{ t moduleRV ( R R t mod( ( RV s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR5 � s c C s d t | j d � � j � S( Nt tmpl_s utf-8( R t encodet hexdigest( R% ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyt get_template_key� s c C s t j | � d S( Ns .py( Ry R� ( R% ( ( s2 /usr/lib/python2.7/site-packages/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� RV t getattrR� R t
__import__t ImportErrorR Rz R{ R| R# t from_module_dictt __dict__( R R R% R& t keyR� R� ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyR, � s
N( R R- R. R8 R R5 t staticmethodR� R� R R R, ( ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyRy � s ( R. RA Rz R� t typesR R t hashlibR t jinja2.exceptionsR t jinja2.utilsR R t jinja2._compatR R R t objectR R0 RL Re Ri Rl Ru Rx Ry ( ( ( s2 /usr/lib/python2.7/site-packages/jinja2/loaders.pyt <module>
s& e9A 6)