Tera

A powerful, fast and easy-to-use template engine for Rust

This crate provides an implementation of the Tera template engine, which is designed for use in Rust applications. Inspired by Jinja2 and Django templates, Tera provides a familiar and expressive syntax for creating dynamic HTML, XML, and other text-based documents. It supports template inheritance, variable interpolation, conditionals, loops, filters, and custom functions, enabling developers to build complex applications with ease.

See the site for more information and to get started.

Features

• High-performance template rendering
• Safe and sandboxed execution environment
• Template inheritance and includes
• Expressive and familiar syntax
• Extensible with custom filters and functions
• Automatic escaping of HTML/XML by default
• Template caching and auto-reloading for efficient development
• Comprehensive error messages and debugging information

Example

use tera::Tera;

// Create a new Tera instance and add a template from a string
let mut tera = Tera::new();
tera.add_raw_template("hello", "Hello, {{ name }}!").unwrap();
// Prepare the context with some data
let mut context = tera::Context::new();
context.insert("name", "World");

// Render the template with the given context
let rendered = tera.render("hello", &context).unwrap();
assert_eq!(rendered, "Hello, World!");

Getting Started

Add the following to your Cargo.toml file:

[dependencies]
# By default no features are selected.
tera = {version = "2", features = ["fast"]}

A few features requiring more dependencies are available:

• fast: speed up template rendering (you can also select only some of the features from that feature group)
• glob_fs: allows loading template on the filesystem using a glob
• unicode: if you want Tera to work with graphemes clusters rather than utf-8 characters when iterating on strings
• preserve_order: keep order of insertion for values

Unless you want to trim down completely on your dependencies, the fast feature should be enabled.

Then, consult the official documentation and examples to learn more about using Tera in your Rust projects.