Mako是一个高性能的Python模板库,它的语法和API借鉴了很多其他的模板库,如Django、Jinja2等等。
基本用法
创建模板并渲染它的最基本的方法是使用 Template 类:
1 2 3 4 5 |
from mako.template import Template t = Template('hello world!') print t.render() |
传给 Template 的文本参数被编译为一个Python模块。模块包含一个 render_body() 函数,它产生模板的输出。调用 render() 方法时,Mako建立了一个模板的运行环境,并调用 render_body() 函数,把输出保存到缓冲,返回它的字符串内容。
render_body() 函数中可以访问一个变量集。可以向 render() 方法发送额外的关键词参数来指定这些变量:
1 2 3 4 5 |
from mako.template import Template t = Template('hello, ${name}!') print t.render(name='yeolar') |
ender() 方法使Mako创建一个 Context 对象,它存储模板可以访问的所有变量和一个用来保存输出的缓冲。也可以自己创建 Context ,用 render_context() 方法使模板用它来渲染:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
from mako.template import Template from mako.runtime import Context from StringIO import StringIO t = Template('hello, ${name}!') buf = StringIO() c = Context(buf, name='yeolar') t.render_context(c) print buf.getValue() |
使用文件模板
Template 也可以从文件加载模板,使用 filename 参数:
1 2 3 4 5 |
from mako.template import Template t = Template(filename='/docs/tpl.txt') print t.render() |
为了提高性能,从文件加载的 Template 还可以在文件系统中将生成的模块缓存为一般的Python模块文件(.py文件),这通过添加 module_directory 参数实现:
1 2 3 4 5 |
from mako.template import Template t = Template(filename='/docs/tpl.txt', module_directory='/tmp/mako_modules') print t.render() |
上面的代码渲染后,会创建一个/tmp/mako_modules/docs/tpl.txt.py文件,其中包含模块的源代码。下次同样参数的 Template 创建时,自动重用这个模块文件。
使用TemplateLookup
到现在的例子都是有关单个 Template 对象的用法。如果模板中的代码要定位其他模板资源,需要某种使用URI来找到它们的方法。这种需求是由 TemplateLookup 类来达到的。这个类通过传入一个模板查找目录的列表来构造,然后作为关键词参数传给 Template 对象:
1 2 3 4 5 6 7 |
from mako.template import Template from mako.lookup import TemplateLookup lookup = TemplateLookup(directories=['/docs']) t = Template('<%include file="header.txt" /> hello word!', lookup=lookup) |
上面创建的模板中包含文件header.txt。为了查找header.txt,传了一个 TemplateLookup 对象给它。
通常,应用会以文本文件形式在文件系统上存储大部分或全部的模板。一个真正的应用会直接从 TemplateLookup 取得它的模板,使用 get_template() 方法,它接受需要的模板的URI作为参数:
1 2 3 4 5 6 7 8 9 10 11 |
from mako.template import Template from mako.lookup import TemplateLookup lookup = TemplateLookup(directories=['/docs'] id="crayon-581284a88d073345049979-4"> lookup = TemplateLookup(directories=['/docs']es notranslate" data-settings=" minimize scroll-always" style=" margin-top: 12px; margin-bottom: 12px; font-size: 13px !important; line-height: 15px !important;">
传给 Template 的文本参数被编译为一个Python模块。模块包含一个 render_body() 函数,它产生模板的输出。调用 render() 方法时,Mako建立了一个模板的运行环境,并调用 render_body() 函数,把输出保存到缓冲,返回它的字符串内容。
ender() 方法使Mako创建一个 Context 对象,它存储模板可以访问的所有变量和一个用来保存输出的缓冲。也可以自己创建 Context ,用 render_context() 方法使模板用它来渲染:
使用文件模板Template 也可以从文件加载模板,使用 filename 参数:
为了提高性能,从文件加载的 Template 还可以在文件系统中将生成的模块缓存为一般的Python模块文件(.py文件),这通过添加 module_directory 参数实现:
上面的代码渲染后,会创建一个/tmp/mako_modules/docs/tpl.txt.py文件,其中包含模块的源代码。下次同样参数的 Template 创建时,自动重用这个模块文件。 使用TemplateLookup到现在的例子都是有关单个 Template 对象的用法。如果模板中的代码要定位其他模板资源,需要某种使用URI来找到它们的方法。这种需求是由 TemplateLookup 类来达到的。这个类通过传入一个模板查找目录的列表来构造,然后作为关键词参数传给 Template 对象:
上面创建的模板中包含文件header.txt。为了查找header.txt,传了一个 TemplateLookup 对象给它。
|