it is better to rule no one
one can live honourably without power
{ leon }

用法

首先将模板解析为令牌列表

use leon::Template;

let template = Template::parse("hello {name}").unwrap();

可以检查模板，例如检查键是否存在

#
assert!(template.has_key("name"));

可以将模板渲染为字符串

use leon::vals;
#
assert_eq!(
    template.render(
        &&vals(|_key| Some("marcus".into()))
    ).unwrap().as_str(),
    "hello marcus",
);

…或写入器

use std::io::Write;
use leon::vals;
#
let mut buf: Vec<u8> = Vec::new();
template.render_into(
    &mut buf,
    &&vals(|key| if key == "name" {
        Some("julius".into())
    } else {
        None
    })
).unwrap();
assert_eq!(buf.as_slice(), b"hello julius");

…使用映射

use std::collections::HashMap;
let mut values = HashMap::new();
values.insert("name", "brutus");
assert_eq!(template.render(&values).unwrap().as_str(), "hello brutus");

…或使用您自己的类型，如果您实现了 Values 特性

use std::borrow::Cow;
use leon::Values;

struct MyMap {
  name: &'static str,
}
impl Values for MyMap {
   fn get_value(&self, key: &str) -> Option<Cow<'_, str>> {
      if key == "name" {
        Some(self.name.into())
     } else {
       None
    }
   }
}
#
let values = MyMap { name: "pontifex" };
assert_eq!(template.render(&values).unwrap().as_str(), "hello pontifex");

编译时解析

您可以使用与常规解析器语法完全相同的leon-macros的template! proc-macro，或者这个crate的template!规则宏，它需要稍有不同的语法，但不会引入额外的依赖。在任一情况下，都需要将leon库作为运行时依赖。

错误

如果模板解析失败，Leon将返回ParseError。这可能是由于括号不匹配或键为空。

如果向[Template::render()]传递的键值中缺少键，Leon将返回RenderError::MissingKey，除非提供了默认值，通过Template.default。

它还会在使用[Template::render_into()]时传递I/O错误。