관리-도구
편집 파일: template.cpython-37.pyc
B �C]�g � @ s d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z ddl m Z ddl mZ ddl mZ ddl mZ dd lmZ G d d � d e�ZG d d � d e�ZG dd� de�ZG dd� de�Zdd� Zdd� Zdd� Zdd� Zdd� Z dS ) z�Provides the Template class, a facade for parsing, generating and executing template strings, as well as template runtime operations.� N)�cache)�codegen)�compat)� exceptions)�runtime)�util)�Lexerc @ s� e Zd ZdZeZd,dd �Zejd d � �Z d d � Z dd� Z e dd� �Z e dd� �Zejdd� �Ze dd� �Ze dd� �Ze dd� �Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Ze d*d+� �ZdS )-�Templatea! Represents a compiled template. :class:`.Template` includes a reference to the original template source (via the :attr:`.source` attribute) as well as the source code of the generated Python module (i.e. the :attr:`.code` attribute), as well as a reference to an actual Python module. :class:`.Template` is constructed using either a literal string representing the template text, or a filename representing a filesystem path to a source file. :param text: textual template source. This argument is mutually exclusive versus the ``filename`` parameter. :param filename: filename of the source template. This argument is mutually exclusive versus the ``text`` parameter. :param buffer_filters: string list of filters to be applied to the output of ``%def``\ s which are buffered, cached, or otherwise filtered, after all filters defined with the ``%def`` itself have been applied. Allows the creation of default expression filters that let the output of return-valued ``%def``\ s "opt out" of that filtering via passing special attributes or objects. :param bytestring_passthrough: When ``True``, and ``output_encoding`` is set to ``None``, and :meth:`.Template.render` is used to render, the `StringIO` or `cStringIO` buffer will be used instead of the default "fast" buffer. This allows raw bytestrings in the output stream, such as in expressions, to pass straight through to the buffer. This flag is forced to ``True`` if ``disable_unicode`` is also configured. .. versionadded:: 0.4 Added to provide the same behavior as that of the previous series. :param cache_args: Dictionary of cache configuration arguments that will be passed to the :class:`.CacheImpl`. See :ref:`caching_toplevel`. :param cache_dir: .. deprecated:: 0.6 Use the ``'dir'`` argument in the ``cache_args`` dictionary. See :ref:`caching_toplevel`. :param cache_enabled: Boolean flag which enables caching of this template. See :ref:`caching_toplevel`. :param cache_impl: String name of a :class:`.CacheImpl` caching implementation to use. Defaults to ``'beaker'``. :param cache_type: .. deprecated:: 0.6 Use the ``'type'`` argument in the ``cache_args`` dictionary. See :ref:`caching_toplevel`. :param cache_url: .. deprecated:: 0.6 Use the ``'url'`` argument in the ``cache_args`` dictionary. See :ref:`caching_toplevel`. :param default_filters: List of string filter names that will be applied to all expressions. See :ref:`filtering_default_filters`. :param disable_unicode: Disables all awareness of Python Unicode objects. See :ref:`unicode_disabled`. :param enable_loop: When ``True``, enable the ``loop`` context variable. This can be set to ``False`` to support templates that may be making usage of the name "``loop``". Individual templates can re-enable the "loop" context by placing the directive ``enable_loop="True"`` inside the ``<%page>`` tag -- see :ref:`migrating_loop`. :param encoding_errors: Error parameter passed to ``encode()`` when string encoding is performed. See :ref:`usage_unicode`. :param error_handler: Python callable which is called whenever compile or runtime exceptions occur. The callable is passed the current context as well as the exception. If the callable returns ``True``, the exception is considered to be handled, else it is re-raised after the function completes. Is used to provide custom error-rendering functions. .. seealso:: :paramref:`.Template.include_error_handler` - include-specific error handler function :param format_exceptions: if ``True``, exceptions which occur during the render phase of this template will be caught and formatted into an HTML error page, which then becomes the rendered result of the :meth:`.render` call. Otherwise, runtime exceptions are propagated outwards. :param imports: String list of Python statements, typically individual "import" lines, which will be placed into the module level preamble of all generated Python modules. See the example in :ref:`filtering_default_filters`. :param future_imports: String list of names to import from `__future__`. These will be concatenated into a comma-separated string and inserted into the beginning of the template, e.g. ``futures_imports=['FOO', 'BAR']`` results in ``from __future__ import FOO, BAR``. If you're interested in using features like the new division operator, you must use future_imports to convey that to the renderer, as otherwise the import will not appear as the first executed statement in the generated code and will therefore not have the desired effect. :param include_error_handler: An error handler that runs when this template is included within another one via the ``<%include>`` tag, and raises an error. Compare to the :paramref:`.Template.error_handler` option. .. versionadded:: 1.0.6 .. seealso:: :paramref:`.Template.error_handler` - top-level error handler function :param input_encoding: Encoding of the template's source code. Can be used in lieu of the coding comment. See :ref:`usage_unicode` as well as :ref:`unicode_toplevel` for details on source encoding. :param lookup: a :class:`.TemplateLookup` instance that will be used for all file lookups via the ``<%namespace>``, ``<%include>``, and ``<%inherit>`` tags. See :ref:`usage_templatelookup`. :param module_directory: Filesystem location where generated Python module files will be placed. :param module_filename: Overrides the filename of the generated Python module file. For advanced usage only. :param module_writer: A callable which overrides how the Python module is written entirely. The callable is passed the encoded source content of the module and the destination path to be written to. The default behavior of module writing uses a tempfile in conjunction with a file move in order to make the operation atomic. So a user-defined module writing function that mimics the default behavior would be: .. sourcecode:: python import tempfile import os import shutil def module_writer(source, outputpath): (dest, name) = \\ tempfile.mkstemp( dir=os.path.dirname(outputpath) ) os.write(dest, source) os.close(dest) shutil.move(name, outputpath) from mako.template import Template mytemplate = Template( filename="index.html", module_directory="/path/to/modules", module_writer=module_writer ) The function is provided for unusual configurations where certain platform-specific permissions or other special steps are needed. :param output_encoding: The encoding to use when :meth:`.render` is called. See :ref:`usage_unicode` as well as :ref:`unicode_toplevel`. :param preprocessor: Python callable which will be passed the full template source before it is parsed. The return result of the callable will be used as the template source code. :param lexer_cls: A :class:`.Lexer` class used to parse the template. The :class:`.Lexer` class is used by default. .. versionadded:: 0.7.4 :param strict_undefined: Replaces the automatic usage of ``UNDEFINED`` for any undeclared variables not located in the :class:`.Context` with an immediate raise of ``NameError``. The advantage is immediate reporting of missing variables which include the name. .. versionadded:: 0.3.6 :param uri: string URI or other identifier for this template. If not provided, the ``uri`` is generated from the filesystem path, or from the in-memory identity of a non-file-based template. The primary usage of the ``uri`` is to provide a key within :class:`.TemplateLookup`, as well as to generate the file path of the generated Python module file, if ``module_directory`` is specified. NF�strict�beakerT� c # C sh |r t �dd|�| _|| _n^|r`t �dd|�| _tj�|�\} } tj�| ��tjj d�} | | _ndt t | �� | _| j| _| j} | � d�r�| dd � } tj�| �} | � d�r�t �d| j ��|| _|| _|| _|| _|p�|| _|| _|| _|| _tj�r |�r t �d��n|�r |�r t �d ��|d k�rNtj�s:| j�rDd g| _nd g| _n|| _|| _|| _ || _ || _ | d k �r|| | _ |d k �r�t | ||�\}!}"|!| _!|| _"t#|"d | ||!||� nd|d k �r|d k �r�|} n2| d k �r tj�$tj�%tj�| �| d ��} nd } | �&| |�}"n t �'d ��|"| _(|| _)| j(j*| _+|| _,|| _-| | _.|| _/| | _0| �1| | | | ||� d S )Nz\W�_�/zmemory:� z..zNTemplate uri "%s" is invalid - it cannot be relative outside of the root path.z4Mako for Python 3 does not support disabling UnicodezAoutput_encoding must be set to None when disable_unicode is used.�str�unicodez.pyz"Template requires text or filename)2�re�sub� module_id�uri�os�path� splitdrive�normpath�replace�sep�hex�id� startswithr ZTemplateLookupException�input_encoding�output_encoding�encoding_errors�disable_unicode�bytestring_passthrough� enable_loop�strict_undefined� module_writerr �py3k�UnsupportedError�default_filters�buffer_filters�imports�future_imports� preprocessor� lexer_cls� _compile_text�_code�_source� ModuleInfo�abspath�join�_compile_from_fileZRuntimeException�module�filename� render_body� callable_�format_exceptions� error_handler�include_error_handler�lookup�module_directory�_setup_cache_args)#�self�textr7 r r: r; r= r r! r> � cache_args� cache_impl� cache_enabled� cache_type� cache_dir� cache_url�module_filenamer r" r& r# r) r* r% r+ r, r$ r- r. r< �driver Zu_norm�coder6 r r �>/opt/alt/python37/lib/python3.7/site-packages/mako/template.py�__init__� s� zTemplate.__init__c C s | j r tjS tj�dg�S d S )NZloop)r$ r ZRESERVED_NAMES� difference)r@ r r rK �reserved_namesu s zTemplate.reserved_namesc C sL || _ || _|r|| _ni | _|r,|| jd< |r:|| jd< |rH|| jd< d S )N�type�dir�url)rC rD rB )r@ rC rD rB rE rF rG r r rK r? | s zTemplate._setup_cache_argsc C s |d k r�t �tj�|�� t�|�tj }tj�|�rJt�|�tj |k rft �|�}t | |||| j � t � | j |�}tj| j = |jtjkr�t �|�}t | |||| j � t � | j |�}tj| j = t||| |d d d � n:t �|�}t| ||�\}}d | _|| _t|d | ||d d � |S )N)r Zverify_directoryr r �dirname�stat�ST_MTIME�exists� read_file�_compile_module_filer& r � load_moduler �sys�modulesZ _magic_numberr � MAGIC_NUMBERr2 r/ r1 r0 )r@ r r7 Z filemtime�datar6 rJ r r rK r5 � s. zTemplate._compile_from_filec C s t | j�jS )z<Return the template source code for this :class:`.Template`.)� _get_module_info_from_callabler9 �source)r@ r r rK r^ � s zTemplate.sourcec C s t | j�jS )z:Return the module source code for this :class:`.Template`.)r] r9 rJ )r@ r r rK rJ � s z Template.codec C s t �| �S )N)r �Cache)r@ r r rK r � s zTemplate.cachec C s | j d S )NrP )rB )r@ r r rK rF � s zTemplate.cache_dirc C s | j d S )NrQ )rB )r@ r r rK rG � s zTemplate.cache_urlc C s | j d S )NrO )rB )r@ r r rK rE � s zTemplate.cache_typec O s t �| | j||�S )a� Render the output of this template as a string. If the template specifies an output encoding, the string will be encoded accordingly, else the output is raw (raw output uses `cStringIO` and can't handle multibyte characters). A :class:`.Context` object is created corresponding to the given data. Arguments that are explicitly declared by this template's internal rendering method are also pulled from the given ``*args``, ``**data`` members. )r �_renderr9 )r@ �argsr\ r r rK �render� s zTemplate.renderc O s t j| | j||dd�S )z7Render the output of this template as a unicode object.T)Z as_unicode)r r` r9 )r@ ra r\ r r rK �render_unicode� s zTemplate.render_unicodec O s6 t |dd�dkr|�| � tj| | j|f|�|� dS )zvRender this :class:`.Template` with the given context. The data is written to the context's buffer. Z_with_templateN)�getattrZ_set_with_templater Z_render_contextr9 )r@ �contextra �kwargsr r rK �render_context� s zTemplate.render_contextc C s t | jd| �S )Nz render_%s)�hasattrr6 )r@ �namer r rK �has_def� s zTemplate.has_defc C s t | t| jd| ��S )z9Return a def of this template as a :class:`.DefTemplate`.z render_%s)� DefTemplaterd r6 )r@ ri r r rK �get_def� s zTemplate.get_defc C s dd� t | j�D �S )zQreturn a list of defs in the template. .. versionadded:: 1.0.4 c S s( g | ] }|d d� dkr|dd � �qS )N� Zrender_r )�.0�ir r rK � <listcomp>� s z&Template.list_defs.<locals>.<listcomp>)rP r6 )r@ r r rK � list_defs� s zTemplate.list_defsc C s t | jd| �S )Nz render_%s)rd r6 )r@ ri r r rK �_get_def_callable� s zTemplate._get_def_callablec C s | j jS )N)r6 Z_modified_time)r@ r r rK � last_modified s zTemplate.last_modified) NNNFNNNr NNr TNNNNNFNFNr FNNTNNN)�__name__� __module__� __qualname__�__doc__r r. rL r Zmemoized_propertyrN r? r5 �propertyr^ rJ r rF rG rE rb rc rg rj rl rq rr rs r r r rK r sb P g r c @ s e Zd ZdZd dd�ZdS ) �ModuleTemplatea) A Template which is constructed given an existing Python module. e.g.:: t = Template("this is a template") f = file("mymodule.py", "w") f.write(t.code) f.close() import mymodule t = ModuleTemplate(mymodule) print t.render() Nr Fr Tc C s� t �dd|j�| _|j| _|j| _|| _|| _| | _ | p:| | _ |j | _ t jr\| r\t�d��n|rn| rnt�d��|| _|| _t||| ||||j� | jj| _| | _| | _|| _| | _| �||||||� d S )Nz\Wr z4Mako for Python 3 does not support disabling UnicodezAoutput_encoding must be set to None when disable_unicode is used.)r r Z _template_urir r �_source_encodingr r r! r" r# Z _enable_loopr$ r r' r r( r6 r7 r2 r8 r9 r: r; r< r= r? )r@ r6 rH �template�template_filename� module_source�template_sourcer r! r" r# r: r; r= rB rC rD rE rF rG r< r r rK rL sH zModuleTemplate.__init__)NNNNNNr FFFNNNr TNNNN)rt ru rv rw rL r r r rK ry s( ry c @ s e Zd ZdZdd� Zdd� ZdS )rk zNA :class:`.Template` which represents a callable def in a parent template.c C sX || _ || _|j| _|j| _|j| _|j| _|j| _|j| _|j| _|j | _ |j | _ d S )N) �parentr9 r r6 r! r: r; r< r$ r= r# )r@ r r9 r r rK rL c s zDefTemplate.__init__c C s | j �|�S )N)r rl )r@ ri r r rK rl p s zDefTemplate.get_defN)rt ru rv rw rL rl r r r rK rk ^ s rk c @ sF e Zd ZdZe�� Zdd� Zed dd��Z e dd� �Z e d d � �Z d S ) r2 z�Stores information about a module currently loaded into memory, provides reverse lookups of template source, module source code based on a module's identifier. c C sH || _ || _|| _|| _|| _|| _| | j|j< |_|rD| | j|< d S )N) r6 rH r| r} r~ � template_uri�_modulesrt Z_mmarker)r@ r6 rH r{ r| r} r~ r� r r rK rL ~ s zModuleInfo.__init__Fc C s� t �d|t j��d�}t�|�}tdd� |d �� D ��|d< |r�g }|d< |d }d}x0tdt |��D ] }||kr~|| }|� |� qjW |S )Nz'__M_BEGIN_METADATA(.+?)__M_END_METADATAr c s s" | ]\}}t |�t |�fV qd S )N)�int)rn �k�vr r rK � <genexpr>� s z8ModuleInfo.get_module_source_metadata.<locals>.<genexpr>�line_map� full_line_map) r �search�S�group�json�loads�dict�items�range�max�append)�clsr} r� Z source_mapZ f_line_mapr� Zcurr_templ_lineZmod_liner r rK �get_module_source_metadata� s z%ModuleInfo.get_module_source_metadatac C s | j d k r| j S t�| j�S d S )N)r} r Zread_python_filerH )r@ r r rK rJ � s zModuleInfo.codec C sb | j d k r8| jjr0t| j tj�s0| j �| jj�S | j S n&t�| j �}| jjrZ|�| jj�S |S d S )N) r~ r6 rz � isinstancer � text_type�decoder rV r| )r@ r\ r r rK r^ � s zModuleInfo.sourceN)F) rt ru rv rw �weakref�WeakValueDictionaryr� rL � classmethodr� rx rJ r^ r r r rK r2 t s r2 c C sb | j ||| j| j| jd�}|�� }tj|| j|| j| j | j | j |j || j| j | j| jd� }||fS )N)r" r r- ) r) r* r+ r, Zsource_encoding�generate_magic_commentr" r% r$ rN )r. r" r r- �parser �compiler r) r* r+ r, �encodingr% r$ rN )r{ rA r7 r� �lexer�noder^ r r rK �_compile� s, r� c C sh | j }t| ||| jd�\}}|}tjs:t|tj�r:|�� }t� |�}t ||d�}t ||j |j � ||fS )N)r� �exec) r r� r" r r' r� r� �encode�types� ModuleTyper� r� �__dict__) r{ rA r7 � identifierr^ r� Zcidr6 rJ r r rK r/ � s r/ c C s~ t | ||dd�\}}t|tj�r0|�|jp,d�}|r@|||� n:tjtj � |�d�\}}t� ||� t� |� t �||� d S )NT)r� �ascii)rP )r� r� r r� r� r� �tempfile�mkstempr r rR �write�close�shutil�move) r{ rA r7 Z outputpathr& r^ r� �destri r r rK rW � s rW c C s& t jrt| jd �S t| jd �S d S )Nrt )r r' �_get_module_info� __globals__Z func_globals)r9 r r rK r] s r] c C s t j| S )N)r2 r� )r7 r r rK r� s r� ) rw r� r r r� rS rY r� r� r� �makor r r r r r Z mako.lexerr �objectr ry rk r2 r� r/ rW r] r� r r r rK �<module> s8 mWL