web-url 0.10.0-rc.1

This library aids in processing web-based URLs.
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

use std::fmt::{Display, Formatter};

use crate::parse::Error::*;

/// An error parsing a web-based URL.
#[derive(Copy, Clone, Ord, PartialOrd, Eq, PartialEq, Hash, Debug)]
pub enum Error {
    /// The scheme was invalid.
    InvalidScheme,

    /// The host was invalid.
    InvalidHost,

    /// The port was invalid.
    InvalidPort,

    /// The path was invalid.
    InvalidPath,

    /// The query was invalid.
    InvalidQuery,

    /// The query parameter was invalid.
    InvalidParam,

    /// The fragment was invalid.
    InvalidFragment,

    /// The URL was too long. (must be under 4 GiB)
    UrlTooLong,
}

impl Error {
    //! Display

    /// Gets the error message.
    pub const fn message(&self) -> &'static str {
        match self {
            InvalidScheme => "invalid scheme",
            InvalidHost => "invalid host",
            InvalidPort => "invalid port",
            InvalidPath => "invalid path",
            InvalidQuery => "invalid query",
            InvalidParam => "invalid query parameter",
            InvalidFragment => "invalid fragment",
            UrlTooLong => "URL too long (>= 4 GiB)",
        }
    }
}

impl Display for Error {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.message())
    }
}

impl std::error::Error for Error {}