Struct Engine 

pub struct Engine { /* private fields */ }

Loads templates from a directory and renders them.

One engine is built at boot and shared; render takes &self so handlers can render concurrently.

Implementations

impl Engine

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

pub fn with_reload(self, reload: bool) -> Self

Re-read every template from disk on every render.

This is the whole reason the engine interprets an AST instead of generating Rust: with reload on, a designer edits a template, hits refresh, and sees the change — no recompile, no restart. Leave it off in production, where the parse should happen once.

pub fn with_translator(self, translator: Arc<dyn Translate>) -> Self

Give @lang somewhere to look.

Without one the directive renders the key it was given, which is the same thing a missing translation does — a page saying auth.sign_in is a page somebody fixes.

pub fn routes_cell(&self) -> Arc<OnceLock<Arc<dyn Routes>>>

The cell the finished router is put into. App fills this; nothing else should.

pub fn root(&self) -> &Path

pub fn reloads(&self) -> bool

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

Whether a view exists on disk.

pub fn clear_cache(&self)

Forget every parsed template.

pub fn render(&self, name: &str, context: &Context) -> Result<String>

Render the view name — "pages.home" or "pages/home" — with context as its data.

pub fn render_source( &self, name: &str, source: &str, context: &Context, ) -> Result<String>

Render a template held in memory, still resolving @include and @extends through this engine’s root.

Useful for a mail body assembled in code, and for tests that have no reason to touch the disk.

Trait Implementations

impl Default for Engine

fn default() -> Self

Returns the “default value” for a type.