interface_rs/interface/
family.rs

1use std::error::Error;
2use std::fmt;
3use std::str::FromStr;
4
5/// Represents the address family in the `interfaces(5)` file.
6///
7/// The `Family` enum constrains the `family` field to allowed values, ensuring
8/// that only valid address families are used.
9///
10/// # Variants
11///
12/// - `Inet`: Represents the `inet` family (IPv4).
13/// - `Inet6`: Represents the `inet6` family (IPv6).
14/// - `IpX`: Represents the `ipx` family.
15/// - `Can`: Represents the `can` family.
16///
17/// # Examples
18///
19/// Parsing a `Family` from a string:
20///
21/// ```rust
22/// use interface_rs::interface::Family;
23/// use std::str::FromStr;
24///
25/// let family = Family::from_str("inet").unwrap();
26/// assert_eq!(family, Family::Inet);
27/// ```
28#[derive(Debug, Clone, PartialEq)]
29pub enum Family {
30    /// The `inet` address family (IPv4).
31    Inet,
32    /// The `inet6` address family (IPv6).
33    Inet6,
34    /// The `ipx` address family.
35    IpX,
36    /// The `can` address family.
37    Can,
38}
39
40impl fmt::Display for Family {
41    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
42        let family_str = match self {
43            Family::Inet => "inet",
44            Family::Inet6 => "inet6",
45            Family::IpX => "ipx",
46            Family::Can => "can",
47        };
48        write!(f, "{}", family_str)
49    }
50}
51
52impl FromStr for Family {
53    type Err = FamilyParseError;
54
55    /// Parses a `Family` from a string slice.
56    ///
57    /// # Errors
58    ///
59    /// Returns a `FamilyParseError` if the input string does not match any known family.
60    fn from_str(s: &str) -> Result<Self, Self::Err> {
61        match s {
62            "inet" => Ok(Family::Inet),
63            "inet6" => Ok(Family::Inet6),
64            "ipx" => Ok(Family::IpX),
65            "can" => Ok(Family::Can),
66            _ => Err(FamilyParseError(s.to_string())),
67        }
68    }
69}
70
71/// An error that occurs when parsing a `Family` from a string.
72///
73/// This error is returned when the input string does not correspond to any
74/// known address family.
75#[derive(Debug, Clone)]
76pub struct FamilyParseError(pub String);
77
78impl fmt::Display for FamilyParseError {
79    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
80        write!(f, "Invalid family: {}", self.0)
81    }
82}
83
84impl Error for FamilyParseError {}
85
86#[cfg(test)]
87mod tests {
88    use super::*;
89
90    #[test]
91    fn test_family_from_str() {
92        assert_eq!(Family::from_str("inet").unwrap(), Family::Inet);
93        assert_eq!(Family::from_str("inet6").unwrap(), Family::Inet6);
94        assert_eq!(Family::from_str("ipx").unwrap(), Family::IpX);
95        assert_eq!(Family::from_str("can").unwrap(), Family::Can);
96    }
97
98    #[test]
99    fn test_family_from_str_invalid() {
100        let err = Family::from_str("invalid").unwrap_err();
101        assert_eq!(err.0, "invalid");
102        assert_eq!(err.to_string(), "Invalid family: invalid");
103    }
104
105    #[test]
106    fn test_family_display() {
107        assert_eq!(Family::Inet.to_string(), "inet");
108        assert_eq!(Family::Inet6.to_string(), "inet6");
109        assert_eq!(Family::IpX.to_string(), "ipx");
110        assert_eq!(Family::Can.to_string(), "can");
111    }
112
113    #[test]
114    fn test_family_roundtrip() {
115        for family in [Family::Inet, Family::Inet6, Family::IpX, Family::Can] {
116            let s = family.to_string();
117            let parsed: Family = s.parse().unwrap();
118            assert_eq!(parsed, family);
119        }
120    }
121}
interface_rs/interface/family.rs

interface_rs/interface/
family.rs
