ipnetwork 0.21.1

A library to work with IP CIDRs in Rust
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

use std::{error::Error, fmt, net::AddrParseError};

use crate::error::IpNetworkError::*;

/// Represents a bunch of errors that can occur while working with a `IpNetwork`
#[derive(Debug, Clone, PartialEq, Eq)]
#[non_exhaustive]
pub enum IpNetworkError {
    InvalidAddr(String),
    InvalidPrefix,
    InvalidCidrFormat(String),
    NetworkSizeError(NetworkSizeError),
}

impl fmt::Display for IpNetworkError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match *self {
            InvalidAddr(ref s) => write!(f, "invalid address: {s}"),
            InvalidPrefix => write!(f, "invalid prefix"),
            InvalidCidrFormat(ref s) => write!(f, "invalid cidr format: {s}"),
            NetworkSizeError(ref e) => write!(f, "network size error: {e}"),
        }
    }
}

impl Error for IpNetworkError {
    fn description(&self) -> &str {
        match *self {
            InvalidAddr(_) => "address is invalid",
            InvalidPrefix => "prefix is invalid",
            InvalidCidrFormat(_) => "cidr is invalid",
            NetworkSizeError(_) => "network size error",
        }
    }
}

impl From<AddrParseError> for IpNetworkError {
    fn from(e: AddrParseError) -> Self {
        InvalidAddr(e.to_string())
    }
}

/// Cannot convert an IPv6 network size to a u32 as it is a 128-bit value.
#[derive(Copy, Clone, Debug, PartialEq, Eq)]
#[non_exhaustive]
pub enum NetworkSizeError {
    NetworkIsTooLarge,
}

impl fmt::Display for NetworkSizeError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str("Network is too large to fit into an unsigned 32-bit integer!")
    }
}

impl Error for NetworkSizeError {}