Struct TemplateBuilder

Source

pub struct TemplateBuilder { /* private fields */ }

Expand description

A builder for creating and rendering templates using the Tera template engine.

Implementations§

Source §

impl TemplateBuilder

Source

pub fn open<P: AsRef<Path>>(template_path: P) -> Result<Self>

Creates a new TemplateBuilder with the specified template path.

§Arguments

template_path - The path to the template file

§Returns

A new TemplateBuilder instance

§Example

use sal_text::TemplateBuilder;

let builder = TemplateBuilder::open("templates/example.html");

Source

pub fn add_var<S, V>(self, name: S, value: V) -> Self
where S: AsRef<str>, V: Serialize,

Adds a variable to the template context.

§Arguments

name - The name of the variable to add
value - The value to associate with the variable

§Returns

The builder instance for method chaining

§Example

use sal_text::TemplateBuilder;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let builder = TemplateBuilder::open("templates/example.html")?
        .add_var("title", "Hello World")
        .add_var("username", "John Doe");
    Ok(())
}

Source

pub fn add_vars<S, V>(self, vars: HashMap<S, V>) -> Self
where S: AsRef<str>, V: Serialize,

Adds multiple variables to the template context from a HashMap.

§Arguments

vars - A HashMap containing variable names and values

§Returns

The builder instance for method chaining

§Example

use sal_text::TemplateBuilder;
use std::collections::HashMap;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut vars = HashMap::new();
    vars.insert("title", "Hello World");
    vars.insert("username", "John Doe");

    let builder = TemplateBuilder::open("templates/example.html")?
        .add_vars(vars);
    Ok(())
}

Source

pub fn render(&mut self) -> Result<String, Error>

Renders the template with the current context.

§Returns

The rendered template as a string

§Example

use sal_text::TemplateBuilder;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let result = TemplateBuilder::open("templates/example.html")?
        .add_var("title", "Hello World")
        .add_var("username", "John Doe")
        .render()?;

    println!("Rendered template: {}", result);
    Ok(())
}

Source

pub fn render_to_file<P: AsRef<Path>>(&mut self, output_path: P) -> Result<()>

Renders the template and writes the result to a file.

§Arguments

output_path - The path where the rendered template should be written

§Returns

Result indicating success or failure

§Example

use sal_text::TemplateBuilder;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    TemplateBuilder::open("templates/example.html")?
        .add_var("title", "Hello World")
        .add_var("username", "John Doe")
        .render_to_file("output.html")?;
    Ok(())
}