solid-pod-rs-forge 0.5.0-alpha.6

Clean-room Rust Git forge (Gogs/Gitea slice) composed on solid-pod-rs primitives: pod-native issues/PRs, forge push tokens, hosted did:nostr bodies, and Blocktrails anchoring. Cites JavaScriptSolidServer `forge` behaviour by function name only; all code original.
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
86
87
88
89

//! Server-rendered HTML views — zero framework, inline CSS, every
//! interpolation passed through [`crate::request::esc`].
//!
//! There is no templating engine and no client-side JS in the rendered
//! markup: the forge is server-rendered by construction, and the XSS
//! spine is content-type + `esc()` (see [`crate::request`]).

use crate::request::esc;

mod views;
pub use views::*;

/// Minimal inline stylesheet shared by every page. Kept tiny and inline
/// so the forge serves without any external asset dependency.
const STYLE: &str = "\
:root{color-scheme:light dark}\
body{font-family:system-ui,-apple-system,Segoe UI,Roboto,sans-serif;\
max-width:60rem;margin:1.5rem auto;padding:0 1rem;line-height:1.5}\
a{color:#3573b3;text-decoration:none}a:hover{text-decoration:underline}\
header.forge{border-bottom:1px solid #8884;margin-bottom:1rem;padding-bottom:.5rem}\
code,pre{font-family:ui-monospace,SFMono-Regular,Menlo,monospace}\
pre{background:#8881;padding:.75rem;border-radius:6px;overflow-x:auto}\
table{border-collapse:collapse;width:100%}\
td,th{text-align:left;padding:.35rem .5rem;border-bottom:1px solid #8883}\
.muted{color:#8888}.badge{font-size:.8rem;padding:.1rem .45rem;border-radius:10px;background:#8882}\
.state-open{background:#2c9e4b33;color:#2c9e4b}.state-closed{background:#b5433933;color:#b54339}\
.state-merged{background:#8250df33;color:#8250df}\
nav.crumbs{font-size:.95rem;margin-bottom:.75rem}\
";

/// Wrap `body_html` in a full HTML document with a shared header and the
/// inline stylesheet. `title` is escaped; `body_html` must already be
/// composed of `esc()`'d values.
#[must_use]
pub fn page(title: &str, body_html: &str) -> String {
    format!(
        "<!doctype html><html lang=\"en\"><head><meta charset=\"utf-8\">\
<meta name=\"viewport\" content=\"width=device-width,initial-scale=1\">\
<title>{}</title><style>{}</style></head><body>\
<header class=\"forge\"><strong>\u{2692} forge</strong></header>{}</body></html>",
        esc(title),
        STYLE,
        body_html
    )
}

/// Render a breadcrumb nav bar from `(label, href)` pairs. The last
/// entry is rendered as plain (non-link) text.
#[must_use]
pub fn crumbs(items: &[(&str, Option<String>)]) -> String {
    let mut out = String::from("<nav class=\"crumbs\">");
    for (i, (label, href)) in items.iter().enumerate() {
        if i > 0 {
            out.push_str(" / ");
        }
        match href {
            Some(h) => out.push_str(&format!("<a href=\"{}\">{}</a>", esc(h), esc(label))),
            None => out.push_str(&esc(label)),
        }
    }
    out.push_str("</nav>");
    out
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn page_escapes_title() {
        let p = page("<x>", "<p>ok</p>");
        assert!(p.contains("<title>&lt;x&gt;</title>"));
        assert!(p.contains("<p>ok</p>"));
        assert!(p.starts_with("<!doctype html>"));
    }

    #[test]
    fn crumbs_last_is_plain_text() {
        let c = crumbs(&[
            ("home", Some("/forge".into())),
            ("alice", Some("/forge/alice".into())),
            ("repo", None),
        ]);
        assert!(c.contains("<a href=\"/forge\">home</a>"));
        assert!(c.contains(" / repo</nav>"));
        // The final crumb is not a link.
        assert!(!c.contains(">repo</a>"));
    }
}