qcp 0.8.3

Secure remote file copy utility which uses the QUIC protocol over UDP
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

//! CLI helper - Address family
// (c) 2024 Ross Younger

/// Representation of an IP address family
///
/// This is a local type that takes part in the config/CLI system.
#[derive(
    Debug,
    Clone,
    Copy,
    PartialEq,
    Eq,
    strum_macros::EnumString,
    enumscribe::TryUnscribe,
    serde::Serialize,
    enumscribe::EnumDeserialize,
    clap::ValueEnum,
)]
#[serde(rename_all = "lowercase")]
#[strum(ascii_case_insensitive)]
#[enumscribe(case_insensitive)]
pub enum AddressFamily {
    /// IPv4
    Inet,
    /// IPv6
    Inet6,
    /// Unspecified. qcp will use whatever seems suitable given the target address or the result of DNS lookup.
    Any,
}

#[cfg(test)]
#[cfg_attr(coverage_nightly, coverage(off))]
mod test {
    use std::str::FromStr as _;

    use super::AddressFamily;
    use pretty_assertions::assert_eq;

    #[test]
    fn serialize() {
        let a = AddressFamily::Inet;
        let b = AddressFamily::Inet6;
        let c = AddressFamily::Any;

        let aa = serde_json::to_string(&a);
        let bb = serde_json::to_string(&b);
        let cc = serde_json::to_string(&c);
        assert_eq!(aa.unwrap(), "\"inet\"");
        assert_eq!(bb.unwrap(), "\"inet6\"");
        assert_eq!(cc.unwrap(), "\"any\"");
    }

    #[test]
    fn deser_str() {
        use AddressFamily::*;
        for (str, expected) in &[("inet", Inet), ("inet6", Inet6), ("any", Any)] {
            let raw = AddressFamily::from_str(str).expect(str);
            let json = format!(r#""{str}""#);
            let output = serde_json::from_str::<AddressFamily>(&json).expect(str);
            assert_eq!(raw, *expected);
            assert_eq!(output, *expected);
        }
    }

    #[test]
    fn deser_invalid() {
        for s in &["true", "5", r#""5""#, "-1", r#""42"#, r#""string"#] {
            let _ = serde_json::from_str::<AddressFamily>(s).expect_err(s);
        }
    }
}