Template API

模板渲染辅助能力位于 ptool.template 和 p.template 下。

ptool.template.render

v0.1.0 - 引入。

ptool.template.render(template, context) 渲染 Jinja 风格的模板字符串，并返回 渲染结果。

• template（string，必填）：模板源文本。
• context（任意可序列化 Lua 值，必填）：模板上下文。
• 返回：渲染后的字符串。

示例：

local template = ptool.unindent([[
  | {% if user.active %}
  | Hello, {{ user.name }}!
  | {% else %}
  | Inactive user: {{ user.name }}
  | {% endif %}
  | Items:
  | {% for item in items %}
  | - {{ item }}
  | {% endfor %}
]])
local result = ptool.template.render(template, {
  user = { name = "alice", active = true },
  items = { "one", "two", "three" },
})

print(result)

说明：

• context 必须能被序列化成数据值。
• function、thread 和不受支持的 userdata 等 Lua 值，不能作为模板上下文值。
• 缺失值采用可链式的 undefined 语义。这意味着像 foo.bar.baz 这样的嵌套访问， 可以安全传给 default(...) 之类的过滤器而不会报错。若直接渲染且没有后备值， undefined 会变成空字符串。

local template = ptool.unindent([[
  | {{ foo.bar.baz | default("N/A") }}
]])

print(ptool.template.render(template, {})) -- N/A