2 releases

Uses new Rust 2024

0.0.2	Oct 12, 2025
0.0.1	Oct 12, 2025

#286 in Template engine

MIT license

190KB
5K SLoC

sbolt

sbolt is a view template engine in rust. sbolt pre-processes templates from directories and compiles them into crate bits.

sbolt has benefits compared to other templates:

Catch syntactical and logical errors in templates ahead of time.
High scalability as templates go with crate bits.
Better performance for runtime and startup as templates are compiled into bits.

The template syntax is inspired by aspnet Razor syntax which uses @ symbol to transition between CONTENT and rust code. A sample template looks llike bellow: views/welcome.rshtml

@{
    let name = match context.get_data::<String>("name") {
        Some(str) => str,
        None => "",
    };
}
<html>
    <head>
        <title>Welcome</title>
    </head>
    <body>
        <div>Welcome @name!</div>
    </body>
</html>

Getting started

The goal of sbolt is to have your templates and static files accessible to your rust code as a module. And the module will be generated into code living outside of src directory. There are 3 steps to use the crate:

use sbolt to preprocess templates at build stage.

add the crate to deps: Cargo.toml

cargo add sbolt
cargo add sbolt --build

create a build script to process templates: build.rs

fn main() {
    let option = sbolt::codegen::CompilerOptions::default()
        .with_optimize(true)
        .with_source_dir("src/views")
        .with_mod_name("example_views");
    let compiler = sbolt::codegen::Compiler::new(option);
    compiler.compile();
}

include the generated module from build stage and use the logic from generated module.

sbolt::include_views!();
fn main() {
    let mut context = sbolt::context! {
        name: "sbolt".to_string()
    };
    let output = example_views::render("views/welcome", &mut context).unwrap_or_else(|e| {
        eprintln!("Error: {e:?}");
        std::process::exit(1);
    });
    println!("{output}");
}

build and run your crate.

Dependencies

~1–1.5MB
~38K SLoC