A HTML templating library designed for Rust web applications.

Templates are validated and optimized during compilation, catching errors early and ensuring maximum performance.

During development, templates are reloaded every render. (Enabled by default in debug builds, disabled in release for efficiency.)

To install tour, run:

cargo add tour

or add this line to your Cargo.toml in [dependencies] section:

tour = "0.1.0"

// main.rs
use tour::Template;

#[derive(Template)]
#[template(path = "index.html")]
struct Tasks {
    tasks: Vec<String>,
}

fn main() {
    let result = Tasks { tasks: vec![] }.render().unwrap();
    println!("{result}");
}

Templates are searched from templates directory from project root by default.

<!-- templates/index.html -->
{{ for task in tasks }}
    Task: {{ task.get(1..6) }}
{{ else }}
    No Tasks
{{ endfor }}

In debug mode, changing non expression like No Tasks in the source file, will change the output with the new content on the next render without recompiling.

Note that changing expression like {{ for task in tasks }} still requires recompile. An attempt to render it without recompile, will change nothing and may result in error.

This is still better than require to recompile on every small changes. In practice, quick changes iteration is used for style changes.

This project is licensed under the MIT License - see the LICENSE file for details.