File: //proc/self/root/opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyc
�
�ǚPc @ s� d d l Z d d l Z d d l Z d d l Z d d l m Z m Z d d l m Z y d d l Z Wn d d l
Z n Xd e f d � � YZ d e f d � � YZ
d S( i����N( t
exceptionst util( t Templatet TemplateCollectionc B s5 e Z d Z d � Z d d � Z d � Z d � Z RS( s< Represent a collection of :class:`.Template` objects,
identifiable via URI.
A :class:`.TemplateCollection` is linked to the usage of
all template tags that address other templates, such
as ``<%include>``, ``<%namespace>``, and ``<%inherit>``.
The ``file`` attribute of each of those tags refers
to a string URI that is passed to that :class:`.Template`
object's :class:`.TemplateCollection` for resolution.
:class:`.TemplateCollection` is an abstract class,
with the usual default implementation being :class:`.TemplateLookup`.
c C s1 y | j | � t SWn t j k
r, t SXd S( s� Return ``True`` if this :class:`.TemplateLookup` is
capable of returning a :class:`.Template` object for the
given ``uri``.
:param uri: String URI of the template to be resolved.
N( t get_templatet TrueR t TemplateLookupExceptiont False( t selft uri( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyt has_template s
c C s
t � � d S( s� Return a :class:`.Template` object corresponding to the given
``uri``.
The default implementation raises
:class:`.NotImplementedError`. Implementations should
raise :class:`.TemplateLookupException` if the given ``uri``
cannot be resolved.
:param uri: String URI of the template to be resolved.
:param relativeto: if present, the given ``uri`` is assumed to
be relative to this URI.
N( t NotImplementedError( R R t
relativeto( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyR . s c C s | S( sa Convert the given ``filename`` to a URI relative to
this :class:`.TemplateCollection`.( ( R R t filename( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyt filename_to_uri> s c C s | S( s� Adjust the given ``uri`` based on the calling ``filename``.
When this method is called from the runtime, the
``filename`` parameter is taken directly to the ``filename``
attribute of the calling template. Therefore a custom
:class:`.TemplateCollection` subclass can place any string
identifier desired in the ``filename`` parameter of the
:class:`.Template` objects it constructs and have them come back
here.
( ( R R R
( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyt
adjust_uriD s N( t __name__t
__module__t __doc__R
t NoneR R R ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyR s
t TemplateLookupc B s� e Z d Z d
d
e d e d
e e d
d d
d e d
d
d
d
d
d
d e d
e d
d
d � Z d � Z d � Z d � Z d � Z
d � Z d
� Z d � Z
d � Z RS( s� Represent a collection of templates that locates template source files
from the local filesystem.
The primary argument is the ``directories`` argument, the list of
directories to search:
.. sourcecode:: python
lookup = TemplateLookup(["/path/to/templates"])
some_template = lookup.get_template("/index.html")
The :class:`.TemplateLookup` can also be given :class:`.Template` objects
programatically using :meth:`.put_string` or :meth:`.put_template`:
.. sourcecode:: python
lookup = TemplateLookup()
lookup.put_string("base.html", '''
<html><body>${self.next()}</body></html>
''')
lookup.put_string("hello.html", '''
<%include file='base.html'/>
Hello, world !
''')
:param directories: A list of directory names which will be
searched for a particular template URI. The URI is appended
to each directory and the filesystem checked.
:param collection_size: Approximate size of the collection used
to store templates. If left at its default of ``-1``, the size
is unbounded, and a plain Python dictionary is used to
relate URI strings to :class:`.Template` instances.
Otherwise, a least-recently-used cache object is used which
will maintain the size of the collection approximately to
the number given.
:param filesystem_checks: When at its default value of ``True``,
each call to :meth:`.TemplateLookup.get_template()` will
compare the filesystem last modified time to the time in
which an existing :class:`.Template` object was created.
This allows the :class:`.TemplateLookup` to regenerate a
new :class:`.Template` whenever the original source has
been updated. Set this to ``False`` for a very minor
performance increase.
:param modulename_callable: A callable which, when present,
is passed the path of the source file as well as the
requested URI, and then returns the full path of the
generated Python module file. This is used to inject
alternate schemes for Python module location. If left at
its default of ``None``, the built in system of generation
based on ``module_directory`` plus ``uri`` is used.
All other keyword parameters available for
:class:`.Template` are mirrored here. When new
:class:`.Template` objects are created, the keywords
established with this :class:`.TemplateLookup` are passed on
to each new :class:`.Template`.
i����t strictt beakerc C s� g t j | d � D] } t j | � ^ q | _ | | _ | | _ | | _ | | _ | d k rj i } n | r� | j
d | � n | r� | j
d | � n | r� | j
d | � n i | d 6| d 6| d 6| d 6| d 6| d 6|
d
6| d 6| d 6| d
6| d 6|
d 6| d 6| d 6| d 6| d 6| d 6| d 6| _ | d k r]i | _ i | _
n$ t j | � | _ t j | � | _
t j � | _ d S( Nt dirt urlt typet format_exceptionst
error_handlert disable_unicodet bytestring_passthrought output_encodingt
cache_implt encoding_errorst input_encodingt module_directoryt
module_writert
cache_argst
cache_enabledt default_filterst buffer_filterst strict_undefinedt importst enable_loopt preprocessori����( ( R t to_listt posixpatht normpatht directoriesR" t modulename_callablet filesystem_checkst collection_sizeR t
setdefaultt
template_argst _collectiont
_uri_cachet LRUCachet threadingt Lockt _mutex( R R/ R" R1 R2 R R R R R R R$ R R% t
cache_typet cache_dirt cache_urlR0 R# R& R' R( R) R* R! R+ t d( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyt __init__� sN .
c C s� y/ | j r# | j | | j | � S| j | SWn� t k
r� t j d d | � } xe | j D]C } t j t j | | � � } t
j j | � r^ | j
| | � Sq^ Wt j d | � � n Xd S( s� Return a :class:`.Template` object corresponding to the given
``uri``.
.. note:: The ``relativeto`` argument is not supported here at the moment.
s ^\/+t s Cant locate template for uri %rN( R1 t _checkR5 t KeyErrort ret subR/ R- R. t joint ost patht isfilet _loadR t TopLevelLookupException( R R t uR t srcfile( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyR � s
c C s� | | f } | | j k r& | j | S| d d k r� | d k rk t j t j | � | � } | j | <q� d | } | j | <n | } | j | <| S( s9 Adjust the given ``uri`` based on the given relative URI.i t /N( R6 R R- RE t dirname( R R R t keyt v( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyR � s #c C sD y | j | SWn. t k
r? | j | � } | | j | <| SXd S( sa Convert the given ``filename`` to a URI relative to
this :class:`.TemplateCollection`.N( R6 RB t _relativeize( R R
t value( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyR s
c C sR t j | � } x< | j D]- } | d t | � !| k r | t | � Sq Wd Sd S( sk Return the portion of a filename that is 'relative'
to the directories in this lookup.
i N( R- R. R/ t lenR ( R R
R ( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyRQ s
c
C s� | j j � z� y | j | SWn t k
r2 n Xym | j d k rZ | j | | � } n d } t d | d t j | � d | d | | j � | j | <} | SWn | j j
| d � � n XWd | j j � Xd S( NR R
t lookupt module_filename( R: t acquireR5 RB R0 R R R- R. R4 t popt release( R R
R RU t template( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyRI s*
c C s� | j d k r | SyY t j | j � } | j j | t j k rg | j j | d � | j | j | � S| SWn7 t
k
r� | j j | d � t j d | � � n Xd S( Ns Cant locate template for uri %r(
R
R RF t statt modulet _modified_timet ST_MTIMER5 RW RI t OSErrorR R ( R R RY t
template_stat( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyRA = s
c C s) t | d | d | | j �| j | <d S( s� Place a new :class:`.Template` object into this
:class:`.TemplateLookup`, based on the given string of
``text``.
RT R N( R R4 R5 ( R R t text( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyt
put_stringO s
c C s | | j | <d S( s� Place a new :class:`.Template` object into this
:class:`.TemplateLookup`, based on the given
:class:`.Template` object.
N( R5 ( R R RY ( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyt put_template[ s N( ( R R R R R R R? R R R RQ RI RA Ra Rb ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyR R sD ? 0
( RF RZ R- RC t makoR R t
mako.templateR R8 t dummy_threadingt objectR R ( ( ( s< /opt/alt/python27/lib/python2.7/site-packages/mako/lookup.pyt <module> s 0B