nate 0.1.0 - Docs.rs

Not a Template Engine

This is not a template engine, but sugar to implicitly call write!(…) like in PHP, ASP, and everything you hate. The only difference is that the output gets XML escaped automatically unless opted-out explicitly.

E.g.

templates/greeting.html:
```
<h1>Hello, {{user}}!</h1>
```

src/main.rs:

use nate::Nate;

#[derive(Nate)]
#[template(path = "templates/greeting.html")]
struct Greetings<'a> {
    user: &'a str,
}

fn main() {
    let mut output = String::new();
    let tmpl = Greetings { user: "<World>" };
    write!(output, "{}", tmpl).unwrap();
    println!("{}", output);
}

Output:
```
<h1>Hello, &#60;World&#62;!</h1>
```

No new traits are introduced, instead using #[derive(Nate)] works by implementing fmt::Display. This also makes nesting of NaTE templates possible.

A more complex example would be:

src/main.rs:

use nate::Nate;

#[derive(Nate)]
#[template(path = "templates/99-bottles.html")]
struct Template {
    limit: usize,
}

#[test]
fn ninetynine_bottles_of_beer() {
    print!("{}", Template { limit: 99 });
}

templates/99-bottles.txt:

{%-
    for i in (1..=self.limit).rev() {
        if i == 1 {
-%}
1 bottle of beer on the wall.
1 bottle of beer.
Take one down, pass it around.
{%-
        } else {
-%}
{{i}} bottles of beer on the wall.
{{i}} bottles of beer.
Take one down, pass it around.

{%
        }
    }
-%}

Inside of a {% code block %} you can write any and all rust code.

Values in {{ value blocks }} are printed XML escaped.

Values in {{{ raw blocks }}} are printed verbatim.

For values in {{{{ debug blocks }}}} their debug message is printed as in "{:?}".

For values in {{{{{ verbose blocks }}}}} their debug message is printed verbose as in "{:#?}".

Using hyphens - at the start/end of a block, whitespaces before/after the block are trimmed.