safe_uri 0.1.0-beta.4

Simple and safe URI types.
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

use crate::percent_encoded::InvalidPercentEncoded;
use std::{error::Error, fmt};

#[derive(Debug, Clone)]
pub(crate) enum InvalidComponent {
    Byte(InvalidByte),
    PercentEncoded(InvalidPercentEncoded),
    PercentEncodedByte(InvalidPercentEncodedByte),
}

// TODO: maybe remove this impl?
impl Error for InvalidComponent {}

impl fmt::Display for InvalidComponent {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            InvalidComponent::Byte(e) => e.fmt(f),
            InvalidComponent::PercentEncoded(e) => e.fmt(f),
            InvalidComponent::PercentEncodedByte(e) => e.fmt(f),
        }
    }
}

#[derive(Debug, Clone)]
pub(crate) struct InvalidByte {
    pub byte: u8,
}

impl fmt::Display for InvalidByte {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let byte = self.byte;
        let char = char::from(byte);
        write!(f, "byte {byte} ('{char}') is not valid")
    }
}

#[derive(Debug, Clone)]
pub(crate) struct InvalidPercentEncodedByte {
    pub(crate) byte: u8,
}

impl fmt::Display for InvalidPercentEncodedByte {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let byte = self.byte;
        let char = char::from(byte);
        write!(
            f,
            "valid byte {byte} ('{char}') shouldn't be percent encoded (%{byte:X})"
        )
    }
}