sim-lib-net-core 0.1.0-rc.1

Reusable, side-effect-free HTTP/streaming parsing primitives.
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

//! The NetError type for net-core parsing failures.

/// Errors produced by the net-core parsing primitives.
///
/// These describe malformed or oversize wire data only. They carry no I/O or
/// application context; callers translate them into their own error domain.
#[derive(Clone, Debug, PartialEq, Eq)]
pub enum NetError {
    /// The URL did not contain a `scheme://` separator, or was otherwise
    /// structurally malformed (e.g. missing host).
    MalformedUrl(String),
    /// The URL scheme is not one this crate recognizes for default-port
    /// resolution.
    UnsupportedScheme(String),
    /// The URL port component could not be parsed as a `u16`.
    InvalidPort(String),
    /// The HTTP response head (status line + headers) was malformed.
    InvalidHead(String),
    /// A length-prefixed or buffered payload exceeded the caller's size limit.
    OversizeBody(usize),
}

impl core::fmt::Display for NetError {
    fn fmt(&self, formatter: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        match self {
            Self::MalformedUrl(url) => write!(formatter, "malformed url {url}"),
            Self::UnsupportedScheme(scheme) => write!(formatter, "unsupported url scheme {scheme}"),
            Self::InvalidPort(url) => write!(formatter, "invalid port in url {url}"),
            Self::InvalidHead(detail) => write!(formatter, "invalid http head: {detail}"),
            Self::OversizeBody(limit) => {
                write!(formatter, "payload exceeded size limit of {limit} bytes")
            }
        }
    }
}

impl core::error::Error for NetError {}