Incrust

Incrust is a template engine written in Rust, inspired by Jinja2.

The implementation is at a very early stage.

Installation

Incrust is available on crates.io and can be included in your Cargo enabled project like this:

[dependencies] incrust = "0.0"

Then include it in your code like this:

rust extern crate incrust;

Examples

All examples assume prepared instance of incrust. For ease of use hashmaps, we use the macro maplit

```rust

[macro_use]

extern crate maplit; extern crate incrust;

use incrust::Incrust;

fn main() { let incrust = Incrust::new(); // ... } ```

Variables

rust let result = incrust.render_text("Hello, {{name}}!", hashmap!{ "name" => "World", }).unwrap(); assert_eq!(result, "Hello, World!");

Filters

rust let result = incrust.render_text("<h1>{{ text | e }}</h1>", hashmap!{ "text" => "<Cats & Dogs>", }).unwrap(); assert_eq!(result, "<h1>&lt;Cats &amp; Dogs&gt;</h1>");

Comments

rust let tpl = incrust.parse("<p>Visible {# partially #} paragraph</p>").unwrap(); let result = incrust.render_parsed(tpl, hashmap!{}).unwrap(); assert_eq!(result, "<p>Visible paragraph</p>"); }

Escaping

rust let tpl = "Example: {% raw %}{{ mustaches }}{% endraw %}"; let result = incrust.render_text(tpl, hashmap!{}).unwrap(); assert_eq!(result, "Example: {{ mustaches }}");

License

Licensed under either of * Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0) * MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.