api-client-framework 0.1.1

A framework helping to write custom http api clients.
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

//! Adapted from https://github.com/cloudflare/cloudflare-rs

mod async_client;
mod endpoint;

/// Blockscout services related structs.
/// Contains config and client definitions to be used by blockscout-rs services.
#[cfg(feature = "blockscout")]
pub mod blockscout;

pub use async_client::{HttpApiClient, HttpApiClientConfig};
pub use endpoint::{serialize_query, Endpoint};

pub use reqwest;
pub use reqwest_middleware;
pub use url;

/******************** Config definition ********************/

#[derive(Debug, thiserror::Error)]
pub enum Error {
    #[error("middleware error: {0}")]
    Middleware(anyhow::Error),
    #[error("request error: {0}")]
    Request(#[from] reqwest::Error),
    #[error("response deserialization failed: {0}")]
    Deserialization(#[from] serde_path_to_error::Error<serde_json::Error>),
    #[error("request returned with invalid status code: 404 - Not Found")]
    NotFound,
    #[error("request returned with invalid status code: {status_code} - {message}")]
    InvalidStatusCode {
        status_code: reqwest::StatusCode,
        message: String,
    },
    #[error("{0:#?}")]
    CustomError(anyhow::Error),
}

impl From<reqwest_middleware::Error> for Error {
    fn from(value: reqwest_middleware::Error) -> Self {
        match value {
            reqwest_middleware::Error::Middleware(error) => Error::Middleware(error),
            reqwest_middleware::Error::Reqwest(error) => Error::Request(error),
        }
    }
}