ip2d 1.0.0

A converter for IPv4 addresses
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

use std::net::IpAddr::{self, *};
use std::net::Ipv6Addr;

use anyhow::Result;

pub fn to_integer(ip: &str) -> Result<u128> {
    let addr: IpAddr = ip.parse()?;
    match addr {
        V4(a) => {
            let res: u32 = a.into();
            Ok(res as u128)
        }
        V6(a) => Ok(a.into()),
    }
}

pub fn to_str(num: u128, v6: bool) -> String {
    let addr = Ipv6Addr::from(num);
    if v6 {
        return addr.to_string();
    }
    // Try and see if we can return an IPv4 address, otherwise fallback to IPv6.
    match addr.to_ipv4() {
        Some(a) => a.to_string(),
        None => addr.to_string(),
    }
}

#[cfg(test)]
mod tests {
    use super::{to_integer, to_str};

    #[test]
    fn to_integer_works_with_255_0_255_0() {
        let result = to_integer("255.0.255.0").unwrap();
        assert_eq!(result, 4278255360);
    }

    #[test]
    fn to_integer_works_with_0_0_0_1() {
        let result = to_integer("0.0.0.1").unwrap();
        assert_eq!(result, 1);
    }

    #[test]
    fn to_integer_works_with_255_255_255_255() {
        let result = to_integer("255.255.255.255").unwrap();
        assert_eq!(result, 0xFFFFFFFF);
    }

    #[test]
    fn to_integer_works_with_ipv6() {
        let cases = vec!["::1", "2001:4860:4860::8888", "2606:4700:4700::1111"];
        let expected = vec![
            1,
            42541956123769884636017138956568135816,
            50543257694033307102031451402929180945,
        ];
        for (i, case) in cases.iter().enumerate() {
            let result = to_integer(case).unwrap();
            assert_eq!(result, expected[i]);
        }
    }

    #[test]
    fn to_integer_parse_failure() {
        let cases = vec!["256.0.0.0", "1::::1"];
        for case in cases {
            assert!(to_integer(case).is_err());
        }
    }

    #[test]
    fn str_works_with_ipv6() {
        let result = to_str(50543257694033307102031451402929180945, false);
        assert_eq!(result, "2606:4700:4700::1111");
    }

    #[test]
    fn str_works_with_4278255360() {
        let result = to_str(4278255360, false);
        assert_eq!(result, "255.0.255.0");
    }

    #[test]
    fn str_works_with_1() {
        let result = to_str(1, false);
        assert_eq!(result, "0.0.0.1");
    }

    #[test]
    fn str_works_with_4294967295() {
        let result = to_str(4294967295, false);
        assert_eq!(result, "255.255.255.255");
    }
}