templess 0.3

示例 1：简单的插值

作为第一个示例，我们将文本“bar”插值到一个简单的XML文档中的“foo”节点。

>>> xml = """\
... <?xml version="1.0" ?>
... <doc xmlns:t="http://johnnydebris.net/xmlns/templess">
...   <foo t:content="foodata" />
... </doc>
... """
>>> context = {
...     'foodata': 'bar',
... }
>>> t = templess.template(xml)
>>> print t.unicode(context)
<doc>
  <foo>bar</foo>
</doc>

在调用“render()”时，模板将搜索任何Templess指令，并在某个时候找到“t:content”指令。当发生这种情况时，它将在作为参数传递的上下文中查找是否有与属性值对应的键。在我们的情况下，属性的值是“foodata”，因此它将查找键“foodata”，并找到值“bar”。由于此值为字符串类型，因此将其设置为节点的文本值，并在完成后删除该属性。

请注意，如果使用的指令是templess:replace，则doc元素将获得文本内容，foo节点将被删除，因此XML将类似于<doc>bar</doc>。

示例 2：节点插值

在这个示例中，我们将一个新XML节点插值到文档中。此功能提供了一种简单的方法来重用模板。

请注意（XXX目前？）节点需要是一个特殊的Templess节点才能进行插值。将来将提供更方便的方式添加节点（例如使用不那么特定于Templess的API，或者允许来自其他库的XML节点）。

>>> xml = """\
... <?xml version="1.0" ?>
... <doc xmlns:t="http://johnnydebris.net/xmlns/templess">
...   <foo t:content="foodata" />
... </doc>
... """
>>> context = {
...   'foodata': templess.elnode('bar', {}, None),
... }
>>> t = templess.template(xml)
>>> print t.unicode(context)
<doc>
  <foo><bar /></foo>
</doc>

与字符串的情况完全相同，只是将节点文本值设置为上下文的字符串值，而不是将元素节点用作节点的新内容。

一个更有用的例子是插值另一个模板的结果（类似于其他系统中宏的某种程度）

>>> xml_bar = """\
... <?xml version="1.0" ?>
... <bar xmlns:t="http://johnnydebris.net/xmlns/templess"
...      t:content="bardata" />
... """
>>> context_bar = {
...   'bardata': 'baz',
... }
>>> t_bar = templess.template(xml_bar)
>>> xml = """\
... <?xml version="1.0" ?>
... <doc xmlns:t="http://johnnydebris.net/xmlns/templess">
...   <foo t:content="foodata" />
... </doc>
... """
>>> context = {
...   'foodata': t_bar.render(context_bar)
... }
>>> t = templess.template(xml)
>>> print t.unicode(context)
<doc>
  <foo><bar>baz</bar></foo>
</doc>

示例3：字符串值的列表插值

在这个例子中，我们将在文档内部重复某个元素，并将数组的每个实例的内容进行插值。

>>> xml = """\
... <?xml version="1.0" ?>
... <doc xmlns:t="http://johnnydebris.net/xmlns/templess">
...   <foo t:content="foodata" />
... </doc>
... """
>>> context = {
...   'foodata': ['foo', 'bar'],
... }
>>> t = templess.template(xml)
>>> print t.unicode(context)
<doc>
  <foo>foo</foo><foo>bar</foo>
</doc>

当Templess引擎注意到值是列表类型时，它将遍历它，为每个迭代创建节点的副本。从那时起，插值工作方式与正常一样，但是在副本上而不是在原始节点上。当它完成列表迭代后，原始节点将被删除。

注意：节点插值（templess.node子类）的工作方式完全相同，也可以像以前一样使用templess:replace。

注意：当列表的值不是字符串类型时，节点上的插值行为不会相同，请参阅下一个示例。

示例4：字典值的列表插值

在这个例子中，我们将使用字典值作为列表，实际上是在插值过程中递归。递归的上下文是当前上下文值（当前的字典），递归的根是当前元素。

>>> xml = """\
... <?xml version="1.0" ?>
... <doc xmlns:t="http://johnnydebris.net/xmlns/templess">
...   <foo t:content="foodata"><bar t:content="bardata" /></foo>
... </doc>
... """
>>> context = {
...   'foodata': [
...     {'bardata': 'baz'},
...     {'bardata': 'qux'},
...   ],
... }
>>> t = templess.template(xml)
>>> print t.unicode(context)
<doc>
  <foo><bar>baz</bar></foo><foo><bar>qux</bar></foo>
</doc>

当然，这也可以用templess.node实例代替字符串，并且会无限递归，因此您也可以使用列表作为值。当指令是t:replace时，它也会像您预期的那样表现。

示例5：条件渲染

这是一个非常简单的条件渲染示例，因为它是一个非常简单的指令。最终结果将类似于<doc><bar /></doc>。

>>> xml = """\
... <?xml version="1.0" ?>
... <doc xmlns:t="http://johnnydebris.net/xmlns/templess">
...   <foo t:cond="foodata" /><bar t:cond="bardata" />
... </doc>
... """
>>> context = {
...   'foodata': False,
...   'bardata': True,
... }
>>> t = templess.template(xml)
>>> print t.unicode(context)
<doc>
  <bar />
</doc>

当t:cond解析为True时，元素保持不变，当它解析为False时，它将从文档中完全删除。有一个名为“not”的相反指令，它的效果与“cond”正好相反，因此您不是在True值上添加节点，而是在True值上删除它。

示例6：设置属性

设置属性也不太难。'attr'指令为每个包含项生成属性，使用上下文中的值作为属性的值。如果上下文值解析为False，则跳过属性（除非值是''，那么它将产生一个空属性）。

>>> xml = """\
... <?xml version="1.0" ?>
... <doc xmlns:t="http://johnnydebris.net/xmlns/templess">
...   <foo t:attr="bar bardata; baz bazdata; qux quxdata" />
... </doc>
... """
>>> context = {
...   'bardata': 'quux',
...   'bazdata': 'quuux',
...   'quxdata': False,
... }
>>> t = templess.template(xml)
>>> print t.unicode(context)
<doc>
  <foo bar="quux" baz="quuux" />
</doc>