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

use super::context::Context;

/// This is the enumeration of all the different kinds of errors which this

/// crate generates.

#[derive(Debug, Clone, thiserror::Error, PartialEq)]
pub enum Error {
    /// One or more components of the URI contains a non-UTF8 sequence,

    /// and so cannot be converted to a Rust string.

    #[error("URI contains non-UTF8 sequences")]
    CannotExpressAsUtf8(#[from] std::string::FromUtf8Error),

    /// URI begins with an empty scheme, such as `://www.example.com`

    #[error("scheme expected but missing")]
    EmptyScheme,

    /// URI contains a character which is not permitted in the context where it

    /// was encountered; for example, a caret (`^`) in a query:

    /// `http://www.example.com?eat_my_^`

    #[error("illegal character in {0}")]
    IllegalCharacter(Context),

    /// URI contains an incorrect percent encoding, such as

    /// `http://www.example.com?foo=%GG`

    #[error("illegal percent encoding")]
    IllegalPercentEncoding,

    /// URI contains an invalid port number, such as

    /// `http://www.example.com:99999` or `http://www.example.com:foo`

    #[error("illegal port number")]
    IllegalPortNumber(#[source] std::num::ParseIntError),

    /// URI contains an IPv4 address with one or more bad parts, such as

    /// `http://[::ffff:1.2.3.256]/`

    #[error("octet group expected")]
    InvalidDecimalOctet,

    /// URI contains an IP address with missing parts, such as

    /// `http://[::ffff:1.2.3]/`

    #[error("too few address parts")]
    TooFewAddressParts,

    /// URI contains an IP address with too many parts, such as

    /// `http://[::ffff:1.2.3.4.8]/`

    #[error("too many address parts")]
    TooManyAddressParts,

    /// URI contains an IPv6 address with too many digits, such as

    /// `http://[20001:db8:85a3::1]/`

    #[error("too many digits in IPv6 address part")]
    TooManyDigits,

    /// URI contains an IPv6 address with more than one double-colon, such as

    /// `http://[2001:db8:85a3::8a2e::]/`

    #[error("too many double-colons in IPv6 address")]
    TooManyDoubleColons,

    /// URI contains an IPv6 address that is truncated, such as

    /// `http://[2001:db8:85a3::8a2e:0:]/`

    #[error("truncated host")]
    TruncatedHost,
}