tokmd-format 1.10.0

Output formatting and serialization (Markdown, JSON, CSV) for tokmd.
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
90
91
92
93
94
95
96
97
98
99
100
101
102
103

//! SVG badge rendering helpers.

fn escape_xml_text(s: &str) -> String {
    // Minimal XML escaping for text nodes to keep SVG valid and safe.
    let mut out = String::with_capacity(s.len());
    for ch in s.chars() {
        match ch {
            '&' => out.push_str("&"),
            '<' => out.push_str("&lt;"),
            '>' => out.push_str("&gt;"),
            '"' => out.push_str("&quot;"),
            '\'' => out.push_str("&apos;"),
            _ => out.push(ch),
        }
    }
    out
}

/// Build a compact two-segment SVG badge.
pub fn badge_svg(label: &str, value: &str) -> String {
    // Width is heuristic; char count avoids UTF-8 byte-length drift.
    let label_chars = label.chars().count() as i32;
    let value_chars = value.chars().count() as i32;
    let label_width = (label_chars * 7 + 20).max(60);
    let value_width = (value_chars * 7 + 20).max(60);
    let width = label_width + value_width;
    let height = 24;
    let label_x = label_width / 2;
    let value_x = label_width + value_width / 2;
    let label_escaped = escape_xml_text(label);
    let value_escaped = escape_xml_text(value);
    format!(
        "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"{width}\" height=\"{height}\" role=\"img\"><rect width=\"{label_width}\" height=\"{height}\" fill=\"#555\"/><rect x=\"{label_width}\" width=\"{value_width}\" height=\"{height}\" fill=\"#4c9aff\"/><text x=\"{label_x}\" y=\"16\" fill=\"#fff\" font-family=\"Verdana\" font-size=\"11\" text-anchor=\"middle\">{label}</text><text x=\"{value_x}\" y=\"16\" fill=\"#fff\" font-family=\"Verdana\" font-size=\"11\" text-anchor=\"middle\">{value}</text></svg>",
        width = width,
        height = height,
        label_width = label_width,
        value_width = value_width,
        label_x = label_x,
        value_x = value_x,
        label = label_escaped,
        value = value_escaped
    )
}

#[cfg(test)]
mod tests {
    use super::{badge_svg, escape_xml_text};

    #[test]
    fn badge_svg_contains_label_and_value() {
        let svg = badge_svg("lines", "1234");
        assert!(svg.contains("lines"));
        assert!(svg.contains("1234"));
    }

    #[test]
    fn badge_svg_is_valid_svg() {
        let svg = badge_svg("test", "42");
        assert!(svg.starts_with("<svg"));
        assert!(svg.ends_with("</svg>"));
        assert!(svg.contains("xmlns=\"http://www.w3.org/2000/svg\""));
    }

    #[test]
    fn badge_svg_dimensions_calculated_correctly() {
        let svg = badge_svg("ab", "1");
        assert!(svg.contains("width=\"120\""));

        let svg = badge_svg("longlabel", "longvalue");
        assert!(svg.contains("width=\"166\""));
    }

    #[test]
    fn badge_svg_positions_are_centered() {
        let svg = badge_svg("ab", "1");
        assert!(svg.contains("x=\"30\""));
        assert!(svg.contains("x=\"90\""));
    }

    #[test]
    fn badge_svg_width_scales_with_text() {
        let short_svg = badge_svg("a", "1");
        let long_svg = badge_svg("averylonglabel", "averylongvalue");
        assert!(extract_svg_width(&long_svg) > extract_svg_width(&short_svg));
    }

    #[test]
    fn badge_svg_escapes_xml_text_nodes() {
        let label = "a<&>\"'";
        let value = "b<&>\"'";
        let svg = badge_svg(label, value);
        assert!(svg.contains(&escape_xml_text(label)));
        assert!(svg.contains(&escape_xml_text(value)));
        assert!(!svg.contains(label));
        assert!(!svg.contains(value));
    }

    fn extract_svg_width(svg: &str) -> i32 {
        let start = svg.find("width=\"").expect("width attr") + 7;
        let end = svg[start..].find('"').expect("width close") + start;
        svg[start..end].parse().expect("numeric width")
    }
}