Struct Engine 

pub struct Engine { /* private fields */ }

The forge rendering engine.

Wrap Tera with:

• Custom filters: snake_case, pascal_case, camel_case, kebab_case
• Import hoisting filters: collect_import, collect_import_priority
• Import drain function: render_imports()
• Tier-aware template registry

Implementations

impl Engine

pub fn new() -> Self

Create an engine with all forge extensions registered. No templates loaded yet.

pub fn load_dir(&mut self, dir: &Path) -> Result<(), ForgeError>

Load all .jinja and .forge template files from dir recursively. Template names are relative paths from dir with forward slashes.

pub fn load_embedded( &mut self, templates: &[(&str, &str)], ) -> Result<(), ForgeError>

Load templates from embedded (name, content) pairs (for binary embedding).

pub fn add_raw(&mut self, name: &str, content: &str) -> Result<(), ForgeError>

Add a single raw template by name and content string.

pub fn render( &self, name: &str, ctx: &ForgeContext, ) -> Result<String, ForgeError>

Render a template by name with the given context. Resets the ImportCollector and populates slots before rendering.

pub fn render_continue( &self, name: &str, ctx: &ForgeContext, ) -> Result<String, ForgeError>

Render without resetting the ImportCollector or slots. Use when rendering multiple templates in sequence and collecting all their imports.

pub fn tier_of(&self, name: &str) -> Tier

Return the tier of a template based on its path.

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

Check whether a template with this name is loaded.

Trait Implementations

impl Default for Engine

fn default() -> Self

Returns the “default value” for a type.