splashboard 1.2.0

A customizable terminal splash screen with plugin-based data sources
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
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167

//! Bundled language-logo PNG assets (Devicon, MIT — see `assets/logos/LICENSE-devicon.txt`).
//! Maps the `languages::classify` label set onto a `(slug, bytes)` pair so the fetcher can
//! extract a stable per-language file under `$SPLASHBOARD_HOME/cache/logos/<slug>.png` and
//! hand its path to the `media_image` renderer.
//!
//! Languages without a dedicated asset fall through to `_generic.png`. The generic glyph is a
//! plain `</>` square so the `project_codebase` hero never renders empty.

const RUST: &[u8] = include_bytes!("../../../assets/logos/png/rust.png");
const GO: &[u8] = include_bytes!("../../../assets/logos/png/go.png");
const PYTHON: &[u8] = include_bytes!("../../../assets/logos/png/python.png");
const RUBY: &[u8] = include_bytes!("../../../assets/logos/png/ruby.png");
const TYPESCRIPT: &[u8] = include_bytes!("../../../assets/logos/png/typescript.png");
const JAVASCRIPT: &[u8] = include_bytes!("../../../assets/logos/png/javascript.png");
const JAVA: &[u8] = include_bytes!("../../../assets/logos/png/java.png");
const KOTLIN: &[u8] = include_bytes!("../../../assets/logos/png/kotlin.png");
const SCALA: &[u8] = include_bytes!("../../../assets/logos/png/scala.png");
const SWIFT: &[u8] = include_bytes!("../../../assets/logos/png/swift.png");
const C: &[u8] = include_bytes!("../../../assets/logos/png/c.png");
const CPP: &[u8] = include_bytes!("../../../assets/logos/png/cpp.png");
const CSHARP: &[u8] = include_bytes!("../../../assets/logos/png/csharp.png");
const PHP: &[u8] = include_bytes!("../../../assets/logos/png/php.png");
const ELIXIR: &[u8] = include_bytes!("../../../assets/logos/png/elixir.png");
const ERLANG: &[u8] = include_bytes!("../../../assets/logos/png/erlang.png");
const HASKELL: &[u8] = include_bytes!("../../../assets/logos/png/haskell.png");
const CLOJURE: &[u8] = include_bytes!("../../../assets/logos/png/clojure.png");
const OCAML: &[u8] = include_bytes!("../../../assets/logos/png/ocaml.png");
const DART: &[u8] = include_bytes!("../../../assets/logos/png/dart.png");
const LUA: &[u8] = include_bytes!("../../../assets/logos/png/lua.png");
const R: &[u8] = include_bytes!("../../../assets/logos/png/r.png");
const JULIA: &[u8] = include_bytes!("../../../assets/logos/png/julia.png");
const ZIG: &[u8] = include_bytes!("../../../assets/logos/png/zig.png");
const NIM: &[u8] = include_bytes!("../../../assets/logos/png/nim.png");
const SHELL: &[u8] = include_bytes!("../../../assets/logos/png/shell.png");
const POWERSHELL: &[u8] = include_bytes!("../../../assets/logos/png/powershell.png");
const HTML: &[u8] = include_bytes!("../../../assets/logos/png/html.png");
const CSS: &[u8] = include_bytes!("../../../assets/logos/png/css.png");
const VUE: &[u8] = include_bytes!("../../../assets/logos/png/vue.png");
const SVELTE: &[u8] = include_bytes!("../../../assets/logos/png/svelte.png");
const DOCKERFILE: &[u8] = include_bytes!("../../../assets/logos/png/dockerfile.png");
const TERRAFORM: &[u8] = include_bytes!("../../../assets/logos/png/terraform.png");
const PERL: &[u8] = include_bytes!("../../../assets/logos/png/perl.png");
const GROOVY: &[u8] = include_bytes!("../../../assets/logos/png/groovy.png");
const GENERIC: &[u8] = include_bytes!("../../../assets/logos/png/_generic.png");

/// Slug + bytes for `label`. `label` matches the strings emitted by
/// [`super::languages::classify`]. Unknown labels (and unknown extensions, which classify
/// returns `None` for) resolve to the generic `</>` placeholder.
pub fn asset_for(label: Option<&str>) -> (&'static str, &'static [u8]) {
    let Some(name) = label else {
        return ("_generic", GENERIC);
    };
    match name {
        "Rust" => ("rust", RUST),
        "Go" => ("go", GO),
        "Python" => ("python", PYTHON),
        "Ruby" => ("ruby", RUBY),
        "TypeScript" => ("typescript", TYPESCRIPT),
        "JavaScript" => ("javascript", JAVASCRIPT),
        "Java" => ("java", JAVA),
        "Kotlin" => ("kotlin", KOTLIN),
        "Scala" => ("scala", SCALA),
        "Swift" => ("swift", SWIFT),
        "C" => ("c", C),
        "C++" => ("cpp", CPP),
        "C#" => ("csharp", CSHARP),
        "PHP" => ("php", PHP),
        "Elixir" => ("elixir", ELIXIR),
        "Erlang" => ("erlang", ERLANG),
        "Haskell" => ("haskell", HASKELL),
        "Clojure" => ("clojure", CLOJURE),
        "OCaml" => ("ocaml", OCAML),
        "Dart" => ("dart", DART),
        "Lua" => ("lua", LUA),
        "R" => ("r", R),
        "Julia" => ("julia", JULIA),
        "Zig" => ("zig", ZIG),
        "Nim" => ("nim", NIM),
        "Shell" => ("shell", SHELL),
        "PowerShell" => ("powershell", POWERSHELL),
        "HTML" => ("html", HTML),
        "CSS" => ("css", CSS),
        "Vue" => ("vue", VUE),
        "Svelte" => ("svelte", SVELTE),
        "Dockerfile" => ("dockerfile", DOCKERFILE),
        "Terraform" => ("terraform", TERRAFORM),
        "Perl" => ("perl", PERL),
        "Groovy" => ("groovy", GROOVY),
        _ => ("_generic", GENERIC),
    }
}

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

    #[test]
    fn known_labels_map_to_dedicated_assets() {
        let (slug, bytes) = asset_for(Some("Rust"));
        assert_eq!(slug, "rust");
        assert!(!bytes.is_empty());
    }

    #[test]
    fn unknown_label_falls_back_to_generic() {
        let (slug, _) = asset_for(Some("Whitespace"));
        assert_eq!(slug, "_generic");
    }

    #[test]
    fn missing_label_falls_back_to_generic() {
        let (slug, _) = asset_for(None);
        assert_eq!(slug, "_generic");
    }

    #[test]
    fn every_asset_decodes_as_a_real_png() {
        // Catches the case where a future contributor wires a missing/empty `include_bytes!`
        // path — the file would compile but produce garbage at the renderer.
        for label in [
            "Rust",
            "Go",
            "Python",
            "Ruby",
            "TypeScript",
            "JavaScript",
            "Java",
            "Kotlin",
            "Scala",
            "Swift",
            "C",
            "C++",
            "C#",
            "PHP",
            "Elixir",
            "Erlang",
            "Haskell",
            "Clojure",
            "OCaml",
            "Dart",
            "Lua",
            "R",
            "Julia",
            "Zig",
            "Nim",
            "Shell",
            "PowerShell",
            "HTML",
            "CSS",
            "Vue",
            "Svelte",
            "Dockerfile",
            "Terraform",
            "Perl",
            "Groovy",
        ] {
            let (_, bytes) = asset_for(Some(label));
            assert!(
                image::load_from_memory(bytes).is_ok(),
                "asset for {label} did not decode as an image"
            );
        }
        // Generic fallback too.
        let (_, bytes) = asset_for(None);
        assert!(image::load_from_memory(bytes).is_ok());
    }
}