net-lattice-model 0.12.0

The domain model of operating system networking state (routes, interfaces, DNS, ...), with no operating-system dependency.
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

use std::fmt;

/// A MAC (Ethernet hardware) address.
///
/// Stored as six octets in transmission order. No OS dependency — this is
/// pure data, used by `net-lattice-model`'s `interface` module and by
/// backends that read hardware addresses from the OS.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct MacAddress([u8; 6]);

impl MacAddress {
    pub const fn new(octets: [u8; 6]) -> Self {
        Self(octets)
    }

    pub const fn octets(&self) -> [u8; 6] {
        self.0
    }
}

impl fmt::Display for MacAddress {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let [a, b, c, d, e, g] = self.0;
        write!(f, "{a:02x}:{b:02x}:{c:02x}:{d:02x}:{e:02x}:{g:02x}")
    }
}

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

    #[test]
    fn displays_in_colon_hex() {
        let mac = MacAddress::new([0x02, 0x42, 0xab, 0xcd, 0xef, 0x01]);
        assert_eq!(mac.to_string(), "02:42:ab:cd:ef:01");
    }

    #[test]
    fn octets_round_trip() {
        let octets = [0xff; 6];
        let mac = MacAddress::new(octets);
        assert_eq!(mac.octets(), octets);
    }
}