rustango 0.60.7

Batteries-included web framework for Rust: ORM + migrations + auto-admin + multi-tenancy + audit log + auth (sessions, JWT, OAuth2/OIDC, HMAC) + APIs (ViewSet, OpenAPI auto-derive, JSON:API) + jobs (in-mem + Postgres) + email + media (S3 / R2 / B2 / MinIO + presigned uploads + collections + tags) + production middleware (CSRF, CSP, rate-limiting, compression, idempotency, etc.).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

//! Tera template registry, baked into the binary.
//!
//! Every admin template is pulled in with `include_str!`, so the admin
//! needs no files at runtime. The registry is built on first render
//! and held in a `OnceLock`.

use std::sync::OnceLock;

/// The bundled templates, built on first use.
fn templates() -> &'static tera::Tera {
    static T: OnceLock<tera::Tera> = OnceLock::new();
    T.get_or_init(|| {
        let mut tera = crate::template_extensions::html_tera();
        tera.add_raw_templates([
            (
                "_theme_tokens.html",
                include_str!("../styles/theme_tokens.html"),
            ),
            (
                "_admin_styles.html",
                include_str!("templates/_admin_styles.html"),
            ),
            (
                "_theme_toggle.html",
                include_str!("templates/_theme_toggle.html"),
            ),
            ("base.html", include_str!("templates/base.html")),
            ("_sidebar.html", include_str!("templates/_sidebar.html")),
            ("index.html", include_str!("templates/index.html")),
            ("list.html", include_str!("templates/list.html")),
            ("detail.html", include_str!("templates/detail.html")),
            (
                "_inline_panels.html",
                include_str!("templates/_inline_panels.html"),
            ),
            ("form.html", include_str!("templates/form.html")),
            ("login.html", include_str!("templates/login.html")),
            (
                "change_password.html",
                include_str!("templates/change_password.html"),
            ),
            ("audit_log.html", include_str!("templates/audit_log.html")),
            ("docs.html", include_str!("templates/docs.html")),
            (
                "totp_enroll.html",
                include_str!("templates/totp_enroll.html"),
            ),
        ])
        .expect("admin templates compile");
        tera
    })
}

/// Render a bundled template with a serializable context.
///
/// # Panics
/// If the template is missing or the context does not serialize. Both
/// are bugs the tests catch.
pub(crate) fn render_template(template: &str, ctx: &serde_json::Value) -> String {
    let mut tera_ctx = tera::Context::from_serialize(ctx).expect("admin context serializes");
    // Inline tags carry it so a strict `[security] csp` runs them (#1703).
    tera_ctx.insert(
        "csp_nonce",
        &crate::csp_nonce::current().unwrap_or_default(),
    );
    templates()
        .render(template, &tera_ctx)
        .expect("admin template renders")
}

/// Render with extra chrome variables merged into `ctx` just before
/// the render. Views use it to add the sidebar and chrome data without
/// having to know the keys. An existing key in `ctx` wins.
pub(crate) fn render_with_chrome(
    template: &str,
    ctx: &mut serde_json::Value,
    chrome: serde_json::Value,
) -> String {
    if let (Some(map), Some(extra)) = (ctx.as_object_mut(), chrome.as_object()) {
        for (k, v) in extra {
            map.entry(k.clone()).or_insert_with(|| v.clone());
        }
    }
    render_template(template, ctx)
}