用法

简单变量

#
let templ = Template::parse_template("hello {name}").unwrap();
let mut vars: HashMap<String, String> = HashMap::new();
vars.insert("name".into(), "world".into());
let rendered = templ
.render(&RenderOptions {
variables: vars,
..Default::default()
            })
            .unwrap();
assert_eq!(rendered, "hello world");

安全替换，如果不存在则留空，或者使用字面字符串

#
let templ = Template::parse_template("hello {name?} {lastname?\"User\"}").unwrap();
let vars: HashMap<String, String> = HashMap::new();
let rendered = templ
.render(&RenderOptions {
variables: vars,
..Default::default()
            })
            .unwrap();
assert_eq!(rendered, "hello  User");

替代，找到的第一个变量将被替换

#
let templ = Template::parse_template("hello {nickname?name}").unwrap();
let mut vars: HashMap<String, String> = HashMap::new();
vars.insert("name".into(), "world".into());
let rendered = templ
.render(&RenderOptions {
variables: vars,
..Default::default()
            })
            .unwrap();
        assert_eq!(rendered, "hello world");

计算可以写成类似于 lisp 的语言，它支持简单函数。使用 lisp 还可以使您编写更复杂的逻辑。lisp 的实现来自 https://github.com/brundonsmith/rust_lisp，有关功能请参阅那里的 README。

要访问 lisp 中的值，您可以使用以下函数

• st+var : 将值作为字符串，
• st+num 将值作为数字，以及
• st+has 如果值存在则返回 true，否则返回 false。

您需要引用符号以传递给函数（例如 (st+num 'total)）。

否则，您也可以像正常一样在花括号中写入变量。

#
let templ = Template::parse_template("hello {nickname?name}. You've done =(/ (st+num 'task_done) (st+num 'task_total)) work.").unwrap();
let mut vars: HashMap<String, String> = HashMap::new();
vars.insert("name".into(), "world".into());
vars.insert("task_done".into(), "1".into());
vars.insert("task_total".into(), "4".into());
let rendered = templ
.render(&RenderOptions {
variables: vars,
..Default::default()
            })
            .unwrap();
        assert_eq!(rendered, "hello world. You've done 0.25 work.");

自定义命令

#
let templ = Template::parse_template("L=$(printf \"%.2f\" {length})").unwrap();
let mut vars: HashMap<String, String> = HashMap::new();
vars.insert("length".into(), "12.342323".into());
let rendered = templ
.render(&RenderOptions {
wd: PathBuf::from("."),
variables: vars,
shell_commands: true,
            })
            .unwrap();
        assert_eq!(rendered, "L=12.34");

您可以选择关闭自定义命令以确保安全

#
let templ = Template::parse_template("L=$(printf \"%.2f\" {length})").unwrap();
let mut vars: HashMap<String, String> = HashMap::new();
vars.insert("length".into(), "12.342323".into());
let rendered = templ
.render(&RenderOptions {
wd: PathBuf::from("."),
variables: vars,
shell_commands: false,
            })
            .unwrap();
        assert_eq!(rendered, "L=$(printf %.2f 12.342323)");

日期和时间

#
let templ = Template::parse_template("hello {name} at {%Y-%m-%d}").unwrap();
let timefmt = Local::now().format("%Y-%m-%d");
let output = format!("hello world at {}", timefmt);
let mut vars: HashMap<String, String> = HashMap::new();
vars.insert("name".into(), "world".into());
let rendered = templ
.render(&RenderOptions {
wd: PathBuf::from("."),
variables: vars,
shell_commands: false,
            })
            .unwrap();
        assert_eq!(rendered, output);

转换器

尽管没有格式字符串，但有一些转换函数可以进行格式化。我计划根据需要添加更多格式函数。

要将转换器应用于变量，请在变量模板后提供它 VAR_TRANSFORM_SEP_CHAR（目前为 “:”）。

有几个可用的转换器

您可以将转换器依次链接以进行组合操作。例如，count( ):calc(+1) 将提供句子中单词的总数。

示例代码位于transformers中的各个函数中。

#
let mut vars: HashMap<String, String> = HashMap::new();
vars.insert("length".into(), "120.1234".into());
vars.insert("name".into(), "joHN".into());
vars.insert("job".into(), "assistant manager of company".into());
let options = RenderOptions {
variables: vars,
..Default::default()
        };
let cases = [
("L={length}", "L=120.1234"),
("L={length:calc(+100)}", "L=220.1234"),
("L={length:f(.2)} ({length:f(3)})", "L=120.12 (120.123)"),
("hi {name:case(up)}", "hi JOHN"),
(
 "hi {name:case(proper)}, {job:case(title)}",
 "hi John, Assistant Manager of Company",
),
 ("hi {name:case(down)}", "hi john"),
];

for (t, r) in cases {
 let templ = Template::parse_template(t).unwrap();
 let rendered = templ.render(&options).unwrap();
 assert_eq!(rendered, r);
 }

局限性

• 在这个模板系统中，您不能使用位置参数，只能使用命名参数。代码{}将被替换为空字符串。尽管您可以使用"0"、"1"等作为模板和渲染选项变量的变量名，但最好保持名称标识符友好。
• 虽然应该可以工作，但我没有测试过各种名称。
• 目前没有格式说明符，现在您可以使用带有printf bash命令的命令选项来按照您想要的方式格式化内容，或者使用具有有限格式化功能的transformers。例如，模板this is $(printf "%05.2f" {weight}) kg.应该以正确的浮点格式渲染。