b0x 1.0.1

A simple CLI tool to display information about the provided input (integers, IP addresses, strings).
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

//! Deals with IP addresses (`IpAddr`)

use super::*;
use std::net::{IpAddr, Ipv4Addr, Ipv6Addr};

/// Pass sequence for IP addresses (`IpAddr`).
pub struct IpAddrPasses;
impl<'a> PassSequence<'a> for IpAddrPasses {
    type T = IpAddr;
    const TY_NAME: &'static str = "ip";
    const PASSES: &'a [Pass<'a, Self::T>] = pass_sequence![information, conversions];
}

/// Returns the kind of an IPv4 address.
pub fn ip_addr_kind_ipv4(ip: &Ipv4Addr) -> Option<&'static str> {
    match ip {
        _ if ip.is_unspecified() => Some("unspecified"),
        _ if ip.is_loopback() => Some("loopback"),
        _ if ip.is_multicast() => Some("multicast"),

        _ if ip.is_private() => Some("private"),
        _ if ip.is_link_local() => Some("link-local"),
        _ if ip.is_broadcast() => Some("broadcast"),
        _ if ip.is_documentation() => Some("documentation"),

        _ => None,
    }
}

/// Returns the kind of an IPv6 address.
pub fn ip_addr_kind_ipv6(ip: &Ipv6Addr) -> Option<&'static str> {
    match ip {
        _ if ip.is_unspecified() => Some("unspecified"),
        _ if ip.is_loopback() => Some("loopback"),
        _ if ip.is_multicast() => Some("multicast"),

        _ => None,
    }
}

/// Information about the IP address.
pub fn information<'a>(input: &IpAddr) -> Vec<(&'a str, Info)> {
    let mut result = Vec::new();

    match input {
        IpAddr::V4(v) => {
            push!(result, "type", "IPv4");

            match ip_addr_kind_ipv4(&v) {
                Some(kind) => push!(result, "kind", kind),
                None => push!(result, "kind", other),
            };

            push!(result, "octets", &format!("{:?}", v.octets()));
        }
        IpAddr::V6(v) => {
            push!(result, "type", "IPv6");

            match ip_addr_kind_ipv6(&v) {
                Some(kind) => push!(result, "kind", kind),
                None => push!(result, "kind", other),
            };

            push!(result, "octets", &format!("{:?}", v.octets()));
            push!(result, "segments", &format!("{:?}", v.segments()));
        }
    }

    result
}

/// Conversions of an IP address to different types (`IPv4` **->** `IPv6` or `IPv6` **->** `IPv4`).
pub fn conversions<'a>(input: &IpAddr) -> Vec<(&'a str, Info)> {
    let mut result = Vec::new();

    match input {
        IpAddr::V4(v) => {
            push!(result, "ipv6 compatible", v.to_ipv6_compatible());
            push!(result, "ipv6 mapped", v.to_ipv6_mapped());
        }
        IpAddr::V6(v) => {
            match v.to_ipv4() {
                Some(v) => push!(result, "ipv4", v),
                None => push!(result, "ipv4", n / a),
            };
        }
    }

    result
}