curlite 0.2.0

Small blocking HTTP client on top of libcurl: forms, multipart and raw bodies without an async runtime
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

/// Errors returned by this crate.
#[derive(thiserror::Error, Debug)]
#[non_exhaustive]
pub enum Error {
    /// libcurl failed to set an option or perform the transfer. This includes
    /// malformed URLs, which libcurl parses.
    #[error("curl error: {0}")]
    Curl(#[from] curl::Error),
    /// libcurl's multi interface failed.
    #[error("curl multi error: {0}")]
    CurlMulti(#[from] curl::MultiError),
    #[error("invalid header name: {0}")]
    InvalidHeaderName(#[from] http::header::InvalidHeaderName),
    #[error("invalid header value: {0}")]
    InvalidHeaderValue(#[from] http::header::InvalidHeaderValue),
    #[error("invalid status code: {0}")]
    InvalidStatusCode(#[from] http::status::InvalidStatusCode),
    /// A header value could not be represented as a string.
    #[error("header value is not visible ASCII: {0}")]
    HeaderToStr(#[from] http::header::ToStrError),
    /// The server sent a header line this client does not accept.
    #[error("header parse error: {0}")]
    HeaderParse(String),
    #[error("MIME parse error: {0}")]
    Mime(#[from] mime::FromStrError),
    /// A multipart body could not be parsed.
    #[error("multipart parse error: {0}")]
    Multipart(String),
    /// Reading a request body from a reader or writing a response body to a
    /// writer failed.
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),
    /// The server redirected more often than [`Request::max_redirects`]
    /// allows.
    ///
    /// [`Request::max_redirects`]: crate::Request::max_redirects
    #[error("too many redirects (more than {0})")]
    TooManyRedirects(u32),
    #[error("body is not valid UTF-8: {0}")]
    Utf8(#[from] std::str::Utf8Error),
    /// A 4xx or 5xx response, from [`Response::error_for_status`]. The
    /// response is kept for its body.
    ///
    /// [`Response::error_for_status`]: crate::Response::error_for_status
    #[error("HTTP {}", .0.status())]
    Status(Box<crate::Response>),
    /// The request or a redirect points at a URL whose scheme is not `http`
    /// or `https`. Redirects are followed by this crate, so libcurl's own
    /// protocol limits do not apply to them.
    #[error("unsupported URL scheme: {0}")]
    UnsupportedScheme(String),
    /// The response body is larger than [`Request::max_body_size`] allows.
    ///
    /// [`Request::max_body_size`]: crate::Request::max_body_size
    #[error("response body larger than {0} bytes")]
    BodyTooLarge(u64),
    /// JSON serialization or parsing failed.
    #[cfg(feature = "json")]
    #[error("JSON error: {0}")]
    Json(#[from] serde_json::Error),
}

/// Lets `Request::header` take a `HeaderName` or `HeaderValue` directly.
impl From<std::convert::Infallible> for Error {
    fn from(never: std::convert::Infallible) -> Self {
        match never {}
    }
}

pub type Result<T, E = Error> = std::result::Result<T, E>;