splashboard 2.1.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

//! DMI / SMBIOS reads for the `system` fetcher's hardware-identifier kinds.
//!
//! Linux exposes the values as plain files under `/sys/class/dmi/id/`. macOS and Windows would
//! need IOKit / WMI bindings; until those land here, non-Linux callers get `None` and the
//! dispatch renders `"n/a"`.

#[cfg(target_os = "linux")]
const DMI_ROOT: &str = "/sys/class/dmi/id";

pub fn host_vendor() -> Option<String> {
    read_dmi("sys_vendor")
}

pub fn host_model() -> Option<String> {
    read_dmi("product_name")
}

pub fn host_serial() -> Option<String> {
    read_dmi("product_serial")
}

pub fn board_vendor() -> Option<String> {
    read_dmi("board_vendor")
}

pub fn board_model() -> Option<String> {
    read_dmi("board_name")
}

pub fn bios_vendor() -> Option<String> {
    read_dmi("bios_vendor")
}

pub fn bios_version() -> Option<String> {
    read_dmi("bios_version")
}

pub fn bios_date() -> Option<String> {
    read_dmi("bios_date")
}

pub fn chassis() -> Option<String> {
    read_dmi("chassis_type")
        .and_then(|s| s.parse::<u8>().ok())
        .map(chassis_label)
}

#[cfg(target_os = "linux")]
fn read_dmi(name: &str) -> Option<String> {
    std::fs::read_to_string(format!("{DMI_ROOT}/{name}"))
        .ok()
        .map(|s| s.trim().to_string())
        .filter(|s| !s.is_empty())
}

#[cfg(not(target_os = "linux"))]
fn read_dmi(_name: &str) -> Option<String> {
    None
}

/// SMBIOS chassis-type codes (System Management BIOS spec, table 7.4.1).
fn chassis_label(code: u8) -> String {
    match code {
        1 => "Other",
        2 => "Unknown",
        3 => "Desktop",
        4 => "Low Profile Desktop",
        5 => "Pizza Box",
        6 => "Mini Tower",
        7 => "Tower",
        8 => "Portable",
        9 => "Laptop",
        10 => "Notebook",
        11 => "Hand Held",
        12 => "Docking Station",
        13 => "All in One",
        14 => "Sub Notebook",
        15 => "Space-saving",
        16 => "Lunch Box",
        17 => "Main Server Chassis",
        18 => "Expansion Chassis",
        19 => "SubChassis",
        20 => "Bus Expansion Chassis",
        21 => "Peripheral Chassis",
        22 => "RAID Chassis",
        23 => "Rack Mount Chassis",
        24 => "Sealed-case PC",
        25 => "Multi-system",
        26 => "CompactPCI",
        27 => "AdvancedTCA",
        28 => "Blade",
        29 => "Blade Enclosure",
        30 => "Tablet",
        31 => "Convertible",
        32 => "Detachable",
        33 => "IoT Gateway",
        34 => "Embedded PC",
        35 => "Mini PC",
        36 => "Stick PC",
        _ => "Unknown",
    }
    .into()
}

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

    #[test]
    fn chassis_label_covers_known_codes_and_falls_back() {
        assert_eq!(chassis_label(3), "Desktop");
        assert_eq!(chassis_label(9), "Laptop");
        assert_eq!(chassis_label(28), "Blade");
        assert_eq!(chassis_label(99), "Unknown");
    }

    #[cfg(not(target_os = "linux"))]
    #[test]
    fn non_linux_reads_return_none() {
        assert!(host_vendor().is_none());
        assert!(board_model().is_none());
        assert!(chassis().is_none());
    }
}