cabot 0.7.1

Simple HTTP Client.
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

//! Define results and error. `Result<T, CabotError>`
use std::error::Error;
use std::fmt::{self, Display};
use std::string::FromUtf8Error;

use async_std::io::Error as IOError;
use rustls::TLSError;
use url::ParseError as UrlParseError;

#[cfg(feature = "json")]
use serde_json;

#[derive(Debug)]
/// Errors in cabot
pub enum CabotError {
    DNSLookupError(String),
    HostnameParseError(String),
    HttpResponseParseError(String),
    OpaqueUrlError(String),
    SchemeError(String),
    MaxRedirectionAttempt(u8),
    // Wrapped errors
    CertificateError(TLSError),
    EncodingError(FromUtf8Error),
    IOError(IOError),
    UrlParseError(UrlParseError),
    #[cfg(feature = "json")]
    JsonError(serde_json::Error),
}

impl Display for CabotError {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        let description = match self {
            CabotError::DNSLookupError(err) => format!("DNS Lookup Error: {}", err),
            CabotError::HostnameParseError(name) => format!("Invalid Hostname: {}", name),
            CabotError::HttpResponseParseError(err) => {
                format!("HTTP Response Parse Error: {}", err)
            }
            CabotError::OpaqueUrlError(url) => format!("Opaque URL Error: {}", url),
            CabotError::SchemeError(scheme) => format!("Unmanaged Scheme: {}", scheme),
            // Wrapped errors
            CabotError::CertificateError(err) => format!("Certificate Error: {}", err),
            CabotError::EncodingError(err) => format!("Utf8 Encoding Error: {}", err),
            CabotError::IOError(err) => format!("IO Error: {}", err),
            CabotError::UrlParseError(err) => format!("URL Parse Error: {}", err),
            CabotError::MaxRedirectionAttempt(max_redir) => {
                format!("Maximum redirection attempt: {}", max_redir)
            }
            #[cfg(feature = "json")]
            CabotError::JsonError(err) => format!("Json Error: {}", err),
        };
        write!(f, "{}", description)
    }
}

impl Error for CabotError {
    fn source(&self) -> Option<&(dyn Error + 'static)> {
        let err: Option<&(dyn Error + 'static)> = match self {
            CabotError::CertificateError(err) => Some(err),
            CabotError::EncodingError(err) => Some(err),
            CabotError::IOError(err) => Some(err),
            CabotError::UrlParseError(err) => Some(err),
            _ => None,
        };
        err
    }
}

impl From<TLSError> for CabotError {
    fn from(err: TLSError) -> CabotError {
        CabotError::CertificateError(err)
    }
}

impl From<FromUtf8Error> for CabotError {
    fn from(err: FromUtf8Error) -> CabotError {
        CabotError::EncodingError(err)
    }
}

impl From<IOError> for CabotError {
    fn from(err: IOError) -> CabotError {
        CabotError::IOError(err)
    }
}

impl From<UrlParseError> for CabotError {
    fn from(err: UrlParseError) -> CabotError {
        CabotError::UrlParseError(err)
    }
}

#[cfg(feature = "json")]
impl From<serde_json::Error> for CabotError {
    fn from(err: serde_json::Error) -> CabotError {
        CabotError::JsonError(err)
    }
}