9 unstable releases

0.5.4 Nov 26, 2024
0.5.3 Dec 11, 2023
0.5.2 Nov 30, 2023
0.4.0 Nov 21, 2023
0.1.0 Nov 20, 2023

#170 in Template engine

Download history 5636/week @ 2024-08-23 3679/week @ 2024-08-30 1929/week @ 2024-09-06 3254/week @ 2024-09-13 4845/week @ 2024-09-20 5993/week @ 2024-09-27 7520/week @ 2024-10-04 7988/week @ 2024-10-11 9242/week @ 2024-10-18 9208/week @ 2024-10-25 10967/week @ 2024-11-01 10912/week @ 2024-11-08 10902/week @ 2024-11-15 9734/week @ 2024-11-22 8352/week @ 2024-11-29 5282/week @ 2024-12-06

35,909 downloads per month
Used in 6 crates (2 directly)

Apache-2.0

19KB
264 lines

rrgen

A microframework for declarative code generation and injection.

Getting started

Templates use Tera as a templating language (similar to liquid), and use a special metadata/body separation with frontmatter.

The first part of the template instructs what the template should do, and which injections it should perform.

The second part is the actual target file that's being generated.

Example template controller.t:

---
to: tests/fixtures/realistic/generated/controllers/{{name | snake_case }}.rs
injections:
- into: tests/fixtures/realistic/generated/controllers/mod.rs
  append: true
  content: "pub mod {{ name | snake_case }};"
- into: tests/fixtures/realistic/generated/app.rs
  after: "AppRoutes::"
  content: "            .add_route(controllers::{{ name | snake_case }}::routes())"
---
#![allow(clippy::unused_async)]
use axum::{extract::State, routing::get};
use rustyrails::{
    app::AppContext,
    controller::{format, Routes},
    Result,
};

pub async fn echo(req_body: String) -> String {
    req_body
}

pub async fn hello(State(ctx): State<AppContext>) -> Result<String> {
    // do something with context (database, etc)
    format::text("hello")
}

pub fn routes() -> Routes {
    Routes::new()
        .prefix("{{ name | snake_case }}")
        .add("/", get(hello))
        .add("/echo", get(echo))
}

Rendering a template will create one or more files, potentially inject into files, and is done like so:

use std::fs;
use rrgen::Rgen;
use serde_json::json;

let rrgen = RRgen::default();
let vars = json!({"name": "post"});

rrgen.generate(
    &fs::read_to_string("tests/fixtures/test1/template.t").unwrap(),
    &vars,
)
.unwrap();

vars will be variables that are exposed both for the frontmatter part and the body part.

Dependencies

~9–17MB
~243K SLoC