doido-view 0.0.10

Default Tera engine, layouts, partials — Action View style templating for Doido.
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

//! Asset tag helpers (Rails `image_tag`/`stylesheet_link_tag`/`javascript_include_tag`).

use super::escape;

/// Resolve an asset reference to a URL: absolute URLs / rooted paths pass
/// through; a bare name is served from `/assets/`.
fn asset_path(name: &str) -> String {
    if name.starts_with('/') || name.starts_with("http://") || name.starts_with("https://") {
        name.to_string()
    } else {
        format!("/assets/{name}")
    }
}

/// `<img src="/assets/logo.png">`.
pub fn image_tag(src: &str) -> String {
    format!("<img src=\"{}\">", escape(&asset_path(src)))
}

/// An image with `alt` text.
pub fn image_tag_alt(src: &str, alt: &str) -> String {
    format!(
        "<img src=\"{}\" alt=\"{}\">",
        escape(&asset_path(src)),
        escape(alt)
    )
}

/// `<link rel="stylesheet" href="/assets/application.css">`.
pub fn stylesheet_link_tag(name: &str) -> String {
    let href = if name.ends_with(".css") {
        asset_path(name)
    } else {
        asset_path(&format!("{name}.css"))
    };
    format!("<link rel=\"stylesheet\" href=\"{}\">", escape(&href))
}

/// `<script src="/assets/application.js"></script>`.
pub fn javascript_include_tag(name: &str) -> String {
    let src = if name.ends_with(".js") {
        asset_path(name)
    } else {
        asset_path(&format!("{name}.js"))
    };
    format!("<script src=\"{}\"></script>", escape(&src))
}

/// A content digest for cache-busting (Propshaft-style fingerprint).
pub fn digest(content: &[u8]) -> String {
    use std::hash::{Hash, Hasher};
    let mut hasher = std::collections::hash_map::DefaultHasher::new();
    content.hash(&mut hasher);
    format!("{:016x}", hasher.finish())
}

/// A digested asset path: `digested_path("app.css", b"...")` →
/// `/assets/app-<digest>.css`, so changed assets get a fresh URL.
pub fn digested_path(name: &str, content: &[u8]) -> String {
    let d = digest(content);
    match name.rsplit_once('.') {
        Some((stem, ext)) => format!("/assets/{stem}-{d}.{ext}"),
        None => format!("/assets/{name}-{d}"),
    }
}

/// An `<script type="importmap">` tag pinning module names to URLs
/// (importmap-rails). `importmap(&[("app", "/assets/app.js")])`.
pub fn importmap(pins: &[(&str, &str)]) -> String {
    let imports: Vec<String> = pins
        .iter()
        .map(|(name, url)| format!("\"{}\":\"{}\"", escape(name), escape(url)))
        .collect();
    format!(
        "<script type=\"importmap\">{{\"imports\":{{{}}}}}</script>",
        imports.join(",")
    )
}