dsct 0.2.3

LLM-friendly packet dissector CLI
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

//! Protocol-based color theme for the TUI.

use ratatui::style::Color;

/// Palette of visually distinct colors for dark-background terminals.
/// White is intentionally excluded so every protocol gets a colored row.
const PALETTE: &[Color] = &[
    Color::LightBlue,
    Color::LightCyan,
    Color::LightGreen,
    Color::LightMagenta,
    Color::LightRed,
    Color::LightYellow,
    Color::Cyan,
    Color::Green,
    Color::Magenta,
    Color::Yellow,
    Color::Blue,
    Color::Red,
];

/// Return a deterministic text color for the given protocol name.
///
/// The same protocol name always maps to the same color.  Colors are
/// derived by hashing the protocol name and indexing into a fixed palette,
/// so no manual per-protocol mapping is required.
pub fn protocol_color(protocol: &str) -> Color {
    // FNV-1a 32-bit hash — fast, zero dependencies, good avalanche effect.
    let hash = protocol
        .bytes()
        .fold(2166136261u32, |h, b| (h ^ b as u32).wrapping_mul(16777619));
    PALETTE[hash as usize % PALETTE.len()]
}

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

    #[test]
    fn same_protocol_always_same_color() {
        assert_eq!(protocol_color("TCP"), protocol_color("TCP"));
        assert_eq!(protocol_color("DNS"), protocol_color("DNS"));
        assert_eq!(
            protocol_color("UnknownProto"),
            protocol_color("UnknownProto")
        );
    }

    #[test]
    fn color_is_never_white() {
        for proto in &[
            "TCP",
            "UDP",
            "DNS",
            "HTTP",
            "TLS",
            "ICMP",
            "ICMPv6",
            "ARP",
            "DHCP",
            "DHCPv6",
            "SIP",
            "GTPv1-U",
            "GTPv2-C",
            "UnknownProto",
            "OSPF",
            "BGP",
            "SCTP",
            "RADIUS",
        ] {
            assert_ne!(protocol_color(proto), Color::White, "protocol: {proto}");
        }
    }

    #[test]
    fn color_is_in_palette() {
        for proto in &["TCP", "UDP", "DNS", "HTTP", "QUIC", "SomeNewProto"] {
            let c = protocol_color(proto);
            assert!(PALETTE.contains(&c), "protocol: {proto}, color: {c:?}");
        }
    }

    #[test]
    fn distinct_protocols_not_all_same_color() {
        let colors: Vec<Color> = ["TCP", "UDP", "DNS", "HTTP", "TLS", "ICMP"]
            .iter()
            .map(|p| protocol_color(p))
            .collect();
        let unique: std::collections::HashSet<_> = colors.iter().collect();
        assert!(unique.len() > 1, "all protocols got the same color");
    }
}