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

use reqwest::header::InvalidHeaderValue;

use custom_error::custom_error;

/// Result type for `xe621`, using [`xe621::error::Error`].
///
/// [`xe621::error::Error`]: enum.Error.html
pub type Result<T> = ::std::result::Result<T, Error>;

custom_error! { #[doc = "Enum for `xe621` errors."] #[derive(PartialEq)] pub Error
    #[doc = "The given value for the some option is above the maximum value allowed in its"]
    #[doc = "context. E.g.: `order:score limit:350` is an invalid request because the maximum"]
    #[doc = "limit for ordered queries is 320."]
    AboveLimit{option: String, val: u64, max: u64} =
        "{option}:{val} is above the maximum value allowed in this context ({max})",

    #[doc = "An HTTP error has occurred"]
    Http{code: u16, reason: Option<String>} = @{
        format!("HTTP error {}{}", code, match reason {
            Some(reason) => format!(": {}", reason),
            // Give em a generic reason
            None => match code {
                200 => String::from(" OK: Request was successful"),
                403 => String::from(" Forbidden: Access denied. May indicate that your request lacks a User-Agent header."),
                404 => String::from(" Not Found"),
                420 => String::from(" Invalid Record: Record could not be saved"),
                421 => String::from(" User Throttled: User is throttled, try again later"),
                422 => String::from(" Locked: The resource is locked and cannot be modified"),
                423 => String::from(" Already Exists: Resource already exists"),
                424 => String::from(" Invalid Parameters: The given parameters were invalid"),
                500 => String::from(" Internal Server Error: Some unknown error occurred on the server"),
                502 => String::from(" Bad Gateway: A gateway server received an invalid response from the e621 servers"),
                503 => String::from(" Service Unavailable: Server cannot currently handle the request or you have exceeded the request rate limit. Try again later or decrease your rate of requests."),
                520 => String::from(" Unknown Error: Unexpected server response which violates protocol"),
                522 => String::from(" Origin Connection Time-out: CloudFlare's attempt to connect to the e621 servers timed out"),
                524 => String::from(" Origin Connection Time-out: A connection was established between CloudFlare and the e621 servers, but it timed out before an HTTP response was received"),
                525 => String::from(" SSL Handshake Failed: The SSL handshake between CloudFlare and the e621 servers failed"),
                _ => String::new(),
            },
        })
    },

    #[doc = "Serialization error. Contains a description of the error."]
    Serial{desc: String} = "Serialization error: {desc}",

    #[doc = "Post JSON parsing error. The first value is the key of the invalid value, the second"]
    #[doc = "is its value."]
    Deserialization{key: String, value: String} =
        "Invalid JSON value for \"{key}\": {value}",

    #[doc = "The request couldn't be send. Contains a description of the error."]
    CannotSendRequest{desc: String} = "Couldn't send request: {desc}",

    #[doc = "The client couldn't be created. Contains a description of the error."]
    CannotCreateClient{desc: String} = "Couldn't create client: {desc}",

    #[doc = "The given HTTP header is invalid"]
    InvalidHeaderValue{desc: String} = "Invalid header value",
}

impl From<InvalidHeaderValue> for Error {
    fn from(e: InvalidHeaderValue) -> Error {
        Error::InvalidHeaderValue {
            desc: format!("Invalid header value: {}", e),
        }
    }
}