Struct TemplateEngine 

pub struct TemplateEngine { /* private fields */ }

A template engine over a directory of templates.

A view name is dotted and maps to a path: posts.show → <root>/posts/show.view.html.

Implementations

impl TemplateEngine

pub fn new(root: impl Into<PathBuf>) -> Self

Load templates from root, caching parsed output.

pub fn without_cache(self) -> Self

Re-read and re-parse templates on every render.

pub fn with_extension(self, extension: impl Into<String>) -> Self

Use a different file extension.

pub fn root(&self) -> &Path

Where templates are read from.

pub fn path_for(&self, name: &str) -> PathBuf

The file a view name maps to.

Every segment is sanitised and the result is always inside the template root. That matters because a view name can reach the engine from a template (@include('…')) and, in a careless application, from user input. Naively replacing dots with separators is not enough: a name like ..secrets produces a leading separator, and Path::join with a rooted path discards the base — silently reading from the filesystem root.

pub fn flush(&self)

Discard every cached template.

Trait Implementations

impl Debug for TemplateEngine

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl ViewEngine for TemplateEngine

fn render(&self, name: &str, data: &Value) -> Result<String>

Render name with data.

fn exists(&self, name: &str) -> bool

Whether name resolves to a template.

fn render_view(&self, view: &View) -> Result<String>

Render a View.