�
�Tg�0 � �z � S SK r S SKrS SKrS SKrS SKrS SKJr S SKJr S SKJ r " S S5 r
" S S\
5 r g) � N)�
exceptions)�util)�Templatec �4 � \ rS rSrSrS rS S jrS rS rSr g)
�TemplateCollection� a 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 �\ � U R U5 g! [ R a gf = f)z�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.
TF)� get_templater �TemplateLookupException)�self�uris �-/usr/lib/python3/dist-packages/mako/lookup.py� has_template� TemplateCollection.has_template# s0 � � � � � �c� "����1�1� �� �s � �+�+Nc � � [ 5 e)a� 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.
)�NotImplementedError)r r
�
relativetos r r
� TemplateCollection.get_template1 s
� � "�#�#� c � � U$ �zVConvert the given ``filename`` to a URI relative to
this :class:`.TemplateCollection`.� �r r
�filenames r �filename_to_uri�"TemplateCollection.filename_to_uriA s � � �
r c � � U$ )a� 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 s r �
adjust_uri� TemplateCollection.adjust_uriG s � � �
r r )N)
�__name__�
__module__� __qualname__�__firstlineno__�__doc__r r
r r �__static_attributes__r r r r r s � �
� � $� � r r c � � \ rS rSrSr SS jrS rS rS rS r S r
S
r S r S r
S
rg)�TemplateLookup�V a 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`.
Nc � � [ R " US5 Vs/ s H n[ R " U5 PM snU l X l X�l X0l X@l U c 0 n U
( a U R SU
5 U( a U R SU5 U ( a U R SU 5 0 SU_SU_SU_SU_S U
_S
U_S U_S U_S
U_SU _SU _SU_SU_SU_SU_SU_SU_UUS.EU l
US:X a 0 U l 0 U l O6[ R " U5 U l [ R " U5 U l [ R " 5 U l g s snf )Nr �dir�url�type�format_exceptions�
error_handler�include_error_handler�output_encoding�
cache_impl�encoding_errors�input_encoding�module_directory�
module_writer�
cache_args�
cache_enabled�default_filters�buffer_filters�strict_undefined�imports�future_imports� enable_loop)� preprocessor� lexer_cls���)r �to_list� posixpath�normpath� directoriesr4 �modulename_callable�filesystem_checks�collection_size�
setdefault�
template_args� _collection�
_uri_cache�LRUCache� threading�Lock�_mutex) r rD r4 rF rG r- r. r0 r2 r6 r1 r7 �
cache_type� cache_dir� cache_urlrE r5 r8 r9 r: r; r< r= r3 r> r? r/ �ds r �__init__�TemplateLookup.__init__� s� � �< ,0�<�<� �R�+H�
�+H�a�I� � �q� !�+H�
��� !1� �#6� �!2� � .� � � ��J� � � !� !�%�� 3� � � !� !�%�� 3� � � !� !�&�*� 5�
� �!2�
� �]�
�
$�%:�
�
��
�
�*�
�
��
�
�n�
�
� 0�
�
�]�
�
�*�
�
�]�
�
��
�
�n�
�
� 0�
�
�w�
�
�n�!
�"
�;�#
�$ )�"�'
���, �b� � !�D� � �D�O� #�}�}�_� =�D� � "�m�m�O� <�D�O� �n�n�&�� ��]
s � Ec �j � U R ( a U R XR U 5 $ U R U $ ! [ a� n[ R
" SSU5 nU R H� nUR [ R R [ R 5 n[ R " [ R " XC5 5 n[ R R U5 ( d M� U R XQ5 s s SnA$ [ R" " SU- 5 UeSnAff = f)z�Return a :class:`.Template` object corresponding to the given
``uri``.
.. note:: The ``relativeto`` argument is not supported here at
the moment.
z^\/+� N� Can't locate template for uri %r)rF �_checkrJ �KeyError�re�subrD �replace�os�path�seprB rC �join�isfile�_loadr �TopLevelLookupException)r r
�e�u�dir_�srcfiles r r
�TemplateLookup.get_template� s� � � ��%�%��{�{�3�(8�(8��(=�>�>��'�'��,�,��� ����w��C�(�A� �(�(�� �|�|�B�G�G�K�K�� � �?��#�,�,�Y�^�^�D�-D�E���7�7�>�>�'�*�*� �:�:�g�3�3�
)� !�8�8�6��<����� �s/ �.A �A �
D2�
B+D-�9D-� D2� D-�-D2c � � X4nX0R ; a U R U $ US S:X a U=o@R U' U$ Ub; [ R " [ R " U5 U5 =o@R U' U$ SU- =o@R U' U$ )z9Adjust the given ``uri`` based on the given relative URI.r �/)rK rB ra �dirname)r r
r �key�vs r r �TemplateLookup.adjust_uri s� � � � �� �/�/� !��?�?�3�'� '� �q�6�S�=�'*� *�A����$� ��
�
#�'0�~�~��!�!�*�-�s�(�
�A����$�
�� (+�S�y� 0�A����$��r c � � U R U $ ! [ a$ U R U5 nX R U' Us $ f = fr )rK rZ � _relativeize)r r �values r r � TemplateLookup.filename_to_uri sF � � ��?�?�8�,� ,��� ��%�%�h�/�E�(-�O�O�H� %��L� �s � �+?�?c � � [ R " U5 nU R H% nUS[ U5 U:X d M U[ U5 S s $ g)zXReturn the portion of a filename that is 'relative'
to the directories in this lookup.
r N)rB rC rD �len)r r rg s r rq �TemplateLookup._relativeize sM � � �%�%�h�/���$�$�D���C��I�&�$�.� ��D� � �,�,� %� r c �$ � U R R 5 U R U U R R 5 $ ! [ a Of = f U R
b U R X5 nOS n[
SU[ R " U5 U US.U R D6=U R U' nUU R R 5 $ ! U R R US 5 e = f! U R R 5 f = f)N)r
r �lookup�module_filenamer ) rO �acquirerJ �releaserZ rE r rB rC rI �pop)r r r
ry �templates r rc �TemplateLookup._load* s
� � � � ��� � "�
� �'�'��,�.
�K�K� � � !��- �
��
��
��+�+�7�&*�&>�&>�x�&M�O�&*�O�3;� 4�� &� /� /�� 9� �$3� 4�
�(�(� 4� �� � ��%�� �
�K�K� � � !��
� � � �$�$�S�$�/��� �K�K� � � !�s6 �A �
A�C3 �A�C3 �A C � C0�0C3 �3 Dc � � UR c U$ [ R " UR 5 nUR R U[ R
:� a U$ U R R US 5 U R UR U5 $ ! [ a; nU R R US 5 [ R " SU- 5 UeS nAff = f)NrX ) r r^ �stat�module�_modified_time�ST_MTIMErJ r| rc �OSErrorr r )r r
r} �
template_statre s r rY �TemplateLookup._checkI s� � � � � � $��O�
� �G�G�H�$5�$5� 6�M����-�-� �t�}�}�1M�M� �� � � � � ��d� +��:�:�h� /� /��5� 5��� � � � � � ��d� +� �4�4�2�S�8���
�� �s �A B � 7B �
C� 6C�Cc �N � [ U4XS.U R D6U R U' g)zrPlace a new :class:`.Template` object into this
:class:`.TemplateLookup`, based on the given string of
``text``.
)rx r
N)r rI rJ )r r
�texts r �
put_string�TemplateLookup.put_stringY s2 � � !)� �!
� �!
�*.�*<�*<�!
����� r c � � X R U' g)zyPlace a new :class:`.Template` object into this
:class:`.TemplateLookup`, based on the given
:class:`.Template` object.
N)rJ )r r
r} s r � put_template�TemplateLookup.put_templatec s � � !)���� r ) rJ rO rK rG rD rF r4 rE rI )NNTr@ FNN�strictN�beakerTNNNNNNr FNNTNNNN)r r! r" r# r$ rT r
r r rq rc rY r� r� r% r r r r' r' V s� � �>�D � � �� �� � ������� �� �� ������� "�7K'�Z�8�" � � "�>�
�)r r' ) r^ rB r[ r� rM �makor r �
mako.templater r r' r r r �<module>r� s; ��
� � � � � � � "�A� A�HS)�'� S)r