web.py模版系统

介绍:

调用的web.py模版语言Templetor旨在将python的强大功能带入模版。它不是为模板创建新语法,而是重用python语法。

Templetor故意限制模版中的变量访问。用户可以访问传递给模版的变量和一些内置的python函数,这允许不受信任的用户编写模版,而不用担心他们会对正在运行的系统造成损害,当然,可以增加可用的全局变量。

简单的模版:

$def with (name)
Hello $name!

第一行表示定义了一个名为name的参数,$name在渲染模版时,第二行中的名称将替换为name的值。

使用模版系统: 

渲染模版的常用方法是:

render = web.template.render('templates')

return render.hello('world')

该render函数将模版root作为参数。使用给定的参数render.hello(..)调用模版hello.html。实际上,它会hello.* 在模版根目录中查找匹配的文件并选择第一个匹配文件。

也可以使用文件从文件创建模版render.

hello = web.template.frender('templates/hello.html')

print hello('world')

如果将模版作为字符串:

template = "$def with (name)\nHello $name"
hello = web.template.Template(template)
print hello('world')

表达替换: 

特殊字符$用于指定python表达式。表达式可以包含在显示分组中()或{}用于显示分组。

Look, a $string.
Hark, an ${arbitrary + expression}.
Gawk, a $dictionary[key].function('argument').
Cool, a $(limit)ing.

分配: 

定义变量并重新分配一些变量。

$ bug = get_bug(id)
<h1>$bug.title</h1>
<div>
$bug.description
<div>

注意$分配后的空格,需要区分赋值和表达式替换。、、

过滤: 

默认情况下,Templetor使用web.websafe过滤器进行HTML编码。

>>> render.hello("1 < 2")
"Hello 1 &lt; 2"

要使用:后关闭过滤器$:

The following will not be html escaped.
$:form.render()

换行抑制: 

可以通过 \ 在行尾添加字符来抑制换行符。

If you put a backslash \
at the end of a line \
(like these) \
then there will be no newline.

使用$$得到$的输出。

Can you lend me $$50?

$#用作评论指标,任何一$#开头直至行尾的内容都会被忽略。 

控制结构: 

模版系统支持for, while, if, elif 和 else,和在python中一样,语句的主题是缩进的。

$for i in range(10):
I like $i $for i in range(10): I like $i $while a:
hello $a.pop() $if times > max:
Stop! In the name of love.
$else:
Keep on, you can do it.

for 循环中可用的许多变量:

loop.index: the iteration of the loop (1-indexed)
loop.index0: the iteration of the loop (0-indexed)
loop.first: True if first iteration
loop.last: True if last iteration
loop.odd: True if an odd iteration
loop.even: True if an even iteration
loop.parity: "odd" or "even" depending on which is true
loop.parent: the loop above this in nested loops
<table>
$for c in ["a", "b", "c", "d"]:
<tr class="$loop.parity">
<td>$loop.index</td>
<td>$c</td>
</tr>
</table>

web.py模版系统

定义新的模版函数$def .支持关键字参数。

$def say_hello(name='world'):
Hello $name! $say_hello('web.py')
$say_hello()

例子:

$def tr(values):
<tr>
$for v in values:
<td>$v</td>
</tr> $def table(rows):
<table>
$for row in rows:
$:row
</table> $ data = [['a', 'b', 'c'], [1, 2, 3], [2, 4, 6], [3, 6, 9] ]
$:table([tr(d) for d in data])

可以使用code块写入任意python代码。

$code:
x = "you can write any python code here"
y = x.title()
z = len(x + y) def limit(s, width=10):
"""limits a string to the given width"""
if len(s) >= width:
return s[:width] + "..."
else:
return s And we are back to template.
The variables defined in the code block can be used here.
For example, $limit(x)

VAR:  

该var块,可用于在模版结果中定义其他属性。

$def with (title, body)

$var title: $title
$var content_type: text/html <div id="body">
$body
</div>

上述模版的结果可以使用如下:

out = render.page('hello', 'hello world')
out.title
u'hello'
out.content_type
u'text/html'
str(out)
'\n\n<div>\nhello world\n</div>\n'

内置和全局:

就像任何python函数一样,模版也可以访问内置函数及其参数和局部变量。像一些常见的内置函数,range, min,max等,以及布尔值True和False被提供给所有的模版,除了内置函数之外,还可以指定特定于应用程序的全局变量,以使他们可以在所有的模版中访问。

可以将Globals指定为参数web.template.render.

import web
import markdown globals = {'markdown': markdown.markdown}
render = web.template.render('templates', globals=globals)

也可以控制在模版中公开的内置组件。

# disable all builtins
render = web.template.render('templates', builtins={})

安全:

Templetor的设计目标之一是允许不受信任的用户编写模版。

要是模版执行安全,模版中不允许以下内容:

  • 不安全之类的语句import , exec 等等
  • 访问以 。开头的属性_
  • 不安全内建想open,getattr,setattr等等。

SecurityException 如果您的模板使用其中任何一个,则会引发

从web.py 0.2模版升级:

新实现大多与早期实现兼容。但是,由于以下原因,某些情况可能无效。

  • 模板输出始终像TemplateResult对象一样存储,但是将其转换为unicode或者str将结果作为unicode / string。
  • 重新分配全球价值将无效。如果x是全局的,则以下内容不起作用。

  $ x = x + 1

以下仍然受支持,但不是首选。

  • 使用\$转义美元。请$$改用。
  • 修改web.template.Template.globals。将全局变量web.template.render作为参数传递。
上一篇:codeblocks 设置代码自动补全


下一篇:Fiddler工作原理与代理设置