[c@`sdZddlmZmZmZddlZddlZddlZddl Z ddl Z ddl Z ddl m Z ddlmZddlmZmZmZmZerddlmZnddlmZdZeZd Zd efd YZd efd YZdefdYZdefdYZdefdYZ de fdYZ!de fdYZ"de fdYZ#de fdYZ$de fdYZ%de fdYZ&d e fd!YZ'd"e fd#YZ(d$e fd%YZ)d&e fd'YZ*d(e*fd)YZ+d*e fd+YZ,d,e-fd-YZ.d.efd/YZ/d0efd1YZ0d2Z1ddd3Z3dS(4sA simple template system that compiles templates to Python code. Basic usage looks like:: t = template.Template("{{ myvalue }}") print(t.generate(myvalue="XXX")) `Loader` is a class that loads templates from a root directory and caches the compiled templates:: loader = template.Loader("/home/btaylor") print(loader.load("test.html").generate(myvalue="XXX")) We compile all templates to raw Python. Error-reporting is currently... uh, interesting. Syntax for the templates:: ### base.html {% block title %}Default title{% end %} ### bold.html {% extends "base.html" %} {% block title %}A bolder title{% end %} {% block student %}
  • {{ escape(student.name) }}
    • {% end %} Unlike most other template systems, we do not put any restrictions on the expressions you can include in your statements. ``if`` and ``for`` blocks get translated exactly into Python, so you can do complex expressions like:: {% for student in [p for p in people if p.student and p.age > 23] %}
  • {{ escape(student.name) }}
    • {% end %} Translating directly to Python means you can apply functions to expressions easily, like the ``escape()`` function in the examples above. You can pass functions in to your template just like any other variable (In a `.RequestHandler`, override `.RequestHandler.get_template_namespace`):: ### Python code def add(x, y): return x + y template.execute(add=add) ### The template {{ add(1, 2) }} We provide the functions `escape() <.xhtml_escape>`, `.url_escape()`, `.json_encode()`, and `.squeeze()` to all templates by default. Typical applications do not create `Template` or `Loader` instances by hand, but instead use the `~.RequestHandler.render` and `~.RequestHandler.render_string` methods of `tornado.web.RequestHandler`, which load templates automatically based on the ``template_path`` `.Application` setting. Variable names beginning with ``_tt_`` are reserved by the template system and should not be used by application code. Syntax Reference ---------------- Template expressions are surrounded by double curly braces: ``{{ ... }}``. The contents may be any python expression, which will be escaped according to the current autoescape setting and inserted into the output. Other template directives use ``{% %}``. To comment out a section so that it is omitted from the output, surround it with ``{# ... #}``. These tags may be escaped as ``{{!``, ``{%!``, and ``{#!`` if you need to include a literal ``{{``, ``{%``, or ``{#`` in the output. ``{% apply *function* %}...{% end %}`` Applies a function to the output of all template code between ``apply`` and ``end``:: {% apply linkify %}{{name}} said: {{message}}{% end %} Note that as an implementation detail apply blocks are implemented as nested functions and thus may interact strangely with variables set via ``{% set %}``, or the use of ``{% break %}`` or ``{% continue %}`` within loops. ``{% autoescape *function* %}`` Sets the autoescape mode for the current file. This does not affect other files, even those referenced by ``{% include %}``. Note that autoescaping can also be configured globally, at the `.Application` or `Loader`.:: {% autoescape xhtml_escape %} {% autoescape None %} ``{% block *name* %}...{% end %}`` Indicates a named, replaceable block for use with ``{% extends %}``. Blocks in the parent template will be replaced with the contents of the same-named block in a child template.:: {% block title %}Default title{% end %} {% extends "base.html" %} {% block title %}My page title{% end %} ``{% comment ... %}`` A comment which will be removed from the template output. Note that there is no ``{% end %}`` tag; the comment goes from the word ``comment`` to the closing ``%}`` tag. ``{% extends *filename* %}`` Inherit from another template. Templates that use ``extends`` should contain one or more ``block`` tags to replace content from the parent template. Anything in the child template not contained in a ``block`` tag will be ignored. For an example, see the ``{% block %}`` tag. ``{% for *var* in *expr* %}...{% end %}`` Same as the python ``for`` statement. ``{% break %}`` and ``{% continue %}`` may be used inside the loop. ``{% from *x* import *y* %}`` Same as the python ``import`` statement. ``{% if *condition* %}...{% elif *condition* %}...{% else %}...{% end %}`` Conditional statement - outputs the first section whose condition is true. (The ``elif`` and ``else`` sections are optional) ``{% import *module* %}`` Same as the python ``import`` statement. ``{% include *filename* %}`` Includes another template file. The included file can see all the local variables as if it were copied directly to the point of the ``include`` directive (the ``{% autoescape %}`` directive is an exception). Alternately, ``{% module Template(filename, **kwargs) %}`` may be used to include another template with an isolated namespace. ``{% module *expr* %}`` Renders a `~tornado.web.UIModule`. The output of the ``UIModule`` is not escaped:: {% module Template("foo.html", arg=42) %} ``UIModules`` are a feature of the `tornado.web.RequestHandler` class (and specifically its ``render`` method) and will not work when the template system is used on its own in other contexts. ``{% raw *expr* %}`` Outputs the result of the given expression without autoescaping. ``{% set *x* = *y* %}`` Sets a local variable. ``{% try %}...{% except %}...{% else %}...{% finally %}...{% end %}`` Same as the python ``try`` statement. ``{% while *condition* %}... {% end %}`` Same as the python ``while`` statement. ``{% break %}`` and ``{% continue %}`` may be used inside the loop. ``{% whitespace *mode* %}`` Sets the whitespace mode for the remainder of the current file (or until the next ``{% whitespace %}`` directive). See `filter_whitespace` for available options. New in Tornado 4.3. i(tabsolute_importtdivisiontprint_functionN(tescape(tapp_log(t ObjectDicttexec_int unicode_typetPY3(tStringIOt xhtml_escapecC`s}|dkr|S|dkrJtjdd|}tjdd|}|S|dkritjdd|Std |d S( sTransform whitespace in ``text`` according to ``mode``. Available modes are: * ``all``: Return all whitespace unmodified. * ``single``: Collapse consecutive whitespace with a single whitespace character, preserving newlines. * ``oneline``: Collapse all runs of whitespace into a single space character, removing all newlines in the process. .. versionadded:: 4.3 talltsingles([\t ]+)t s (\s*\n\s*)s tonelines(\s+)sinvalid whitespace mode %sN(tretsubt Exception(tmodettext((s/lib/python2.7/site-packages/tornado/template.pytfilter_whitespaces   tTemplatecB`sAeZdZddeeddZdZdZdZRS(sA compiled template. We compile into Python from the given template_string. You can generate the template from variables with generate(). sc C`stj||_|tk rN|d k r9tdn|rEdnd}n|d kr|ru|jru|j}q|jds|jdrd}qd}nt|d|tk r||_ n|r|j |_ n t |_ |r|j ni|_ t |tj||}t |t|||_|j||_||_y>ttj|jd|jjdd d d t|_Wn?tk rt|jj}tjd |j|nXd S(sConstruct a Template. :arg str template_string: the contents of the template file. :arg str name: the filename from which the template was loaded (used for error message). :arg tornado.template.BaseLoader loader: the `~tornado.template.BaseLoader` responsible for this template, used to resolve ``{% include %}`` and ``{% extend %}`` directives. :arg bool compress_whitespace: Deprecated since Tornado 4.3. Equivalent to ``whitespace="single"`` if true and ``whitespace="all"`` if false. :arg str autoescape: The name of a function in the template namespace, or ``None`` to disable escaping by default. :arg str whitespace: A string specifying treatment of whitespace; see `filter_whitespace` for options. .. versionchanged:: 4.3 Added ``whitespace`` parameter; deprecated ``compress_whitespace``. s2cannot set both whitespace and compress_whitespaceR R s.htmls.jsts%s.generated.pyt.t_texect dont_inherits %s code: %sN(Rt native_strtnamet_UNSETtNoneRt whitespacetendswithRt autoescapet_DEFAULT_AUTOESCAPEt namespacet_TemplateReadert_Filet_parsetfilet_generate_pythontcodetloadertcompilet to_unicodetreplacetTruetcompiledt _format_codetrstripRterror( tselfttemplate_stringRR*tcompress_whitespaceR!Rtreadertformatted_code((s/lib/python2.7/site-packages/tornado/template.pyt__init__s@             c `si tjd6tjd6tjd6tjd6tjd6tjd6td6tjd6tt fd 6j j d d d 6t d fdd6}|j j|j |tj||d}tj|S(s0Generate this template with the given arguments.RR t url_escapet json_encodetsqueezetlinkifytdatetimet_tt_utf8t_tt_string_typesRRt__name__t get_sourcec`sjS(N(R)(R(R3(s/lib/python2.7/site-packages/tornado/template.pytPst __loader__t _tt_execute(RR R9R:R;R<R=tutf8RtbytesRR-RtupdateR#RR/t linecachet clearcache(R3tkwargsR#texecute((R3s/lib/python2.7/site-packages/tornado/template.pytgenerateAs$           cC`st}z{i}|j|}|jx|D]}|j||q2Wt||||dj}|dj||jSWd|jXdS(Ni( R t_get_ancestorstreversetfind_named_blockst _CodeWriterttemplateRLtgetvaluetclose(R3R*tbuffert named_blockst ancestorstancestortwriter((s/lib/python2.7/site-packages/tornado/template.pyR(\s    cC`s|jg}xl|jjjD][}t|tr|sFtdn|j|j|j}|j|j |qqW|S(Ns1{% extends %} block found, but no template loader( R'tbodytchunkst isinstancet _ExtendsBlockt ParseErrortloadRtextendRM(R3R*RVtchunkRQ((s/lib/python2.7/site-packages/tornado/template.pyRMls N( R@t __module__t__doc__RRR8RLR(RM(((s/lib/python2.7/site-packages/tornado/template.pyRs A  t BaseLoadercB`sJeZdZedddZdZddZddZdZ RS(sBase class for template loaders. You must use a template loader to use template constructs like ``{% extends %}`` and ``{% include %}``. The loader caches all templates after they are loaded the first time. cC`s=||_|pi|_||_i|_tj|_dS(sConstruct a template loader. :arg str autoescape: The name of a function in the template namespace, such as "xhtml_escape", or ``None`` to disable autoescaping by default. :arg dict namespace: A dictionary to be added to the default template namespace, or ``None``. :arg str whitespace: A string specifying default behavior for whitespace in templates; see `filter_whitespace` for options. Default is "single" for files ending in ".html" and ".js" and "all" for other files. .. versionchanged:: 4.3 Added ``whitespace`` parameter. N(R!R#Rt templatest threadingtRLocktlock(R3R!R#R((s/lib/python2.7/site-packages/tornado/template.pyR8s    cC`s|ji|_WdQXdS(s'Resets the cache of compiled templates.N(RgRd(R3((s/lib/python2.7/site-packages/tornado/template.pytresets cC`s tdS(s@Converts a possibly-relative path to absolute (used internally).N(tNotImplementedError(R3Rt parent_path((s/lib/python2.7/site-packages/tornado/template.pyt resolve_pathscC`s\|j|d|}|j8||jkrG|j||j||jd|j|jd|j|j|jddS(NRs%s:i(RRRt indent_size(R3RX((s/lib/python2.7/site-packages/tornado/template.pyRLZs(R@RaR8RL(((s/lib/python2.7/site-packages/tornado/template.pyRUs t _StatementcB`seZdZdZRS(cC`s||_||_dS(N(RR(R3RR((s/lib/python2.7/site-packages/tornado/template.pyR8as cC`s|j|j|jdS(N(RRR(R3RX((s/lib/python2.7/site-packages/tornado/template.pyRLes(R@RaR8RL(((s/lib/python2.7/site-packages/tornado/template.pyR`s t _ExpressioncB`seZedZdZRS(cC`s||_||_||_dS(N(t expressionRtraw(R3RRR((s/lib/python2.7/site-packages/tornado/template.pyR8js  cC`s|jd|j|j|jd|j|jd|j|j r||jjdk r||jd|jj|jn|jd|jdS(Ns _tt_tmp = %ssEif isinstance(_tt_tmp, _tt_string_types): _tt_tmp = _tt_utf8(_tt_tmp)s&else: _tt_tmp = _tt_utf8(str(_tt_tmp))s_tt_tmp = _tt_utf8(%s(_tt_tmp))s_tt_append(_tt_tmp)(RRRRtcurrent_templateR!R(R3RX((s/lib/python2.7/site-packages/tornado/template.pyRLos   (R@RatFalseR8RL(((s/lib/python2.7/site-packages/tornado/template.pyRis t_ModulecB`seZdZRS(cC`s'tt|jd||dtdS(Ns _tt_modules.R(RnRR8R.(R3RR((s/lib/python2.7/site-packages/tornado/template.pyR8}s(R@RaR8(((s/lib/python2.7/site-packages/tornado/template.pyR|st_TextcB`seZdZdZRS(cC`s||_||_||_dS(N(tvalueRR(R3RRR((s/lib/python2.7/site-packages/tornado/template.pyR8s  cC`sW|j}d|kr*t|j|}n|rS|jdtj||jndS(Ns
    s_tt_append(%r)(RRRRRRER(R3RXR((s/lib/python2.7/site-packages/tornado/template.pyRLs
	(R@RaR8RL(((s/lib/python2.7/site-packages/tornado/template.pyRs	R]cB`s&eZdZdddZdZRS(sRaised for template syntax errors.

    ``ParseError`` instances have ``filename`` and ``lineno`` attributes
    indicating the position of the error.

    .. versionchanged:: 4.3
       Added ``filename`` and ``lineno`` attributes.
    icC`s||_||_||_dS(N(tmessagetfilenametlineno(R3RRR((s/lib/python2.7/site-packages/tornado/template.pyR8s		cC`sd|j|j|jfS(Ns%s at %s:%d(RRR(R3((s/lib/python2.7/site-packages/tornado/template.pyt__str__sN(R@RaRbRR8R(((s/lib/python2.7/site-packages/tornado/template.pyR]sRPcB`s8eZdZdZdZdZddZRS(cC`sC||_||_||_||_d|_g|_d|_dS(Ni(R'RUR*RRt
include_stackt_indent(R3R'RUR*R((s/lib/python2.7/site-packages/tornado/template.pyR8s						cC`s|jS(N(R(R3((s/lib/python2.7/site-packages/tornado/template.pyRsc`s#dtffdY}|S(NtIndenterc`s&eZfdZfdZRS(c`sjd7_S(Ni(R(R(R3(s/lib/python2.7/site-packages/tornado/template.pyt	__enter__sc`s(jdkstjd8_dS(Nii(RtAssertionError(Rtargs(R3(s/lib/python2.7/site-packages/tornado/template.pyt__exit__s(R@RaRR((R3(s/lib/python2.7/site-packages/tornado/template.pyRs(tobject(R3R((R3s/lib/python2.7/site-packages/tornado/template.pyRs	c`sEjjj|f|_dtffdY}|S(NtIncludeTemplatec`s&eZfdZfdZRS(c`sS(N((R(R3(s/lib/python2.7/site-packages/tornado/template.pyRsc`sjjd_dS(Ni(RtpopR(RR(R3(s/lib/python2.7/site-packages/tornado/template.pyRs(R@RaRR((R3(s/lib/python2.7/site-packages/tornado/template.pyRs(RtappendRR(R3RQRR((R3s/lib/python2.7/site-packages/tornado/template.pyRs	cC`s|dkr|j}nd|jj|f}|jrg|jD]\}}d|j|f^qA}|ddjt|7}ntd|||d|jdS(Ns	  # %s:%ds%s:%ds	 (via %s)s, s    R'(	RRRRRRwtreversedtprintR'(R3Rtline_numberRtline_commentttmplRRV((s/lib/python2.7/site-packages/tornado/template.pyRs	, N(R@RaR8RRRRR(((s/lib/python2.7/site-packages/tornado/template.pyRPs
					
R$cB`sYeZdZdd	dZd	dZdZdZdZdZ	dZ
RS(
cC`s1||_||_||_d|_d|_dS(Nii(RRRRtpos(R3RRR((s/lib/python2.7/site-packages/tornado/template.pyR8s
				icC`s|dkst||j}||7}|dkrO|jj||}n4||7}||kskt|jj|||}|dkr||8}n|S(Nii(RRRRtfind(R3tneedletstarttendRtindex((s/lib/python2.7/site-packages/tornado/template.pyRs	


cC`sv|dkr%t|j|j}n|j|}|j|jjd|j|7_|j|j|!}||_|S(Ns
(RRyRRRtcount(R3Rtnewposts((s/lib/python2.7/site-packages/tornado/template.pytconsumes
$	cC`st|j|jS(N(RyRR(R3((s/lib/python2.7/site-packages/tornado/template.pyt	remainingscC`s
|jS(N(R(R3((s/lib/python2.7/site-packages/tornado/template.pyt__len__scC`st|tkrt|}|j|\}}}|dkrN|j}n
||j7}|dk	rw||j7}n|jt|||S|dkr|j|S|j|j|SdS(Ni(ttypetsliceRytindicesRRR(R3tkeytsizeRtstoptstep((s/lib/python2.7/site-packages/tornado/template.pyt__getitem__s
cC`s|j|jS(N(RR(R3((s/lib/python2.7/site-packages/tornado/template.pyRscC`st||j|jdS(N(R]RR(R3tmsg((s/lib/python2.7/site-packages/tornado/template.pytraise_parse_errorsN(R@RaR8RRRRRRRR(((s/lib/python2.7/site-packages/tornado/template.pyR$s						cC`sf|j}dttt|d}djgt|D] \}}||d|f^q?S(Ns%%%dd  %%s
iR(t
splitlinesRytreprRwt	enumerate(R)tlinestformattiR((s/lib/python2.7/site-packages/tornado/template.pyR0s cC`stg}xtrd}xtr|jd|}|dksX|d|jkr|rr|jd|n|jjt|j|j	|j
|S||dd;kr|d7}qn|d|jkr||ddkr||ddkr|d7}qnPqW|dkrU|j|}|jjt||j	|j
n|jd}|j	}|jr|dd	kr|jd|jjt|||j
qn|d
kr|jd}	|	dkr|jdn|j|	j}
|jdqn|d
kr|jd}	|	dkrQ|jdn|j|	j}
|jd|
s|jdn|jjt|
|qn|dkst
||jd}	|	dkr|jdn|j|	j}
|jd|
s#|jdn|
jd\}}}
|
j}
itddddgd6tdgd6tdgd6tdgd6}|j|}|dk	r|s|jd||fn||kr|jd||fn|jjt|
|qq|d kr<|s8|jd!n|S|d<kr"|d'krZqn|d"kr|
jd,jd-}
|
s|jd.nt|
}ni|d=kr|
s|jd/nt|
|}n5|d#kr&|
jd,jd-}
|
s|jd0nt|
||}n|d$krZ|
sH|jd1nt|
|}n|d(kr|
j}|d2krd}n||_qnv|d)kr|
j}t|d3||_
qnB|d*krt|
|d*t}n|d+krt|
|}n|jj|qq|d>kr$|d?krRt||||}n9|d4krvt|||d}nt||||}|d4kr|
s|jd6nt|
||}nL|d5kr|
s|jd7nt|
|||}nt|
||}|jj|qq|d@kr{|s\|jd|tddgfn|jjt|
|qq|jd:|qWdS(ANit{iis Missing {%% end %%} block for %st%t#it!s{#s#}sMissing end comment #}s{{s}}sMissing end expression }}sEmpty expressions{%s%}sMissing end block %}sEmpty block tag ({% %})R
tiftfortwhilettrytelseteliftexcepttfinallys%s outside %s blocks'%s block cannot be attached to %s blockRsExtra {% end %} blocktextendsRtsettimporttfromtcommentR!RRtmodulet"t'sextends missing file pathsimport missing statementsinclude missing file pathsset missing statementRRtapplyRsapply missing method namesblock missing nametbreaktcontinuesunknown operator: %r(RRR(
RRRRRRR!RRR(RR(RRRRRR(RR(RR(RR.RRRRZRRRRRtstripRRt	partitionRtgetRRR\RRR!RRR&RRR(R6RQtin_blocktin_loopRYtcurlytconststart_braceRRtcontentstoperatortspacetsuffixtintermediate_blockstallowed_parentsRtfnRt
block_body((s/lib/python2.7/site-packages/tornado/template.pyR&s		"

(
	




				
		(4Rbt
__future__RRRR=RHtos.pathRoRRRettornadoRttornado.logRttornado.utilRRRRtioR	t	cStringIOR"RRRRRcRmRRR%RRR\RRRRRRRRRR]RPR$R0RR&(((s/lib/python2.7/site-packages/tornado/template.pytsL"		8	1<