apisdk 0.0.16

An easy-to-use API toolkit for writing HTTP API Clients for Rust.
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

use std::{
    any::type_name,
    net::{IpAddr, SocketAddr},
    sync::Arc,
};

use async_trait::async_trait;
use url::Url;

use crate::ApiError;

/// This trait is used to rewrite base_url
#[async_trait]
pub trait UrlRewriter: 'static + Send + Sync {
    /// Rewrite url if possible
    async fn rewrite(&self, url: Url) -> Result<Url, ApiError>;
}

#[async_trait]
impl<F> UrlRewriter for F
where
    F: Fn(Url) -> Result<Url, ApiError>,
    F: 'static + Send + Sync,
{
    async fn rewrite(&self, url: Url) -> Result<Url, ApiError> {
        self(url)
    }
}

#[async_trait]
impl UrlRewriter for IpAddr {
    async fn rewrite(&self, url: Url) -> Result<Url, ApiError> {
        let mut url = url;
        let _ = url.set_ip_host(*self);
        Ok(url)
    }
}

#[async_trait]
impl UrlRewriter for SocketAddr {
    async fn rewrite(&self, url: Url) -> Result<Url, ApiError> {
        let mut url = url;
        let _ = url.set_ip_host(self.ip());
        let _ = url.set_port(Some(self.port()));
        Ok(url)
    }
}

#[async_trait]
impl UrlRewriter for Box<dyn UrlRewriter> {
    async fn rewrite(&self, url: Url) -> Result<Url, ApiError> {
        self.as_ref().rewrite(url).await
    }
}

/// This struct is used to hold the provided `UrlRewriter`, and perform url rewrites
#[derive(Clone)]
pub(crate) struct ReqwestUrlRewriter {
    /// The type_name of provided `UrlRewriter`
    type_name: &'static str,
    /// The provided `UrlRewriter`
    rewriter: Arc<dyn UrlRewriter>,
}

impl ReqwestUrlRewriter {
    pub fn new<T>(rewriter: T) -> Self
    where
        T: UrlRewriter,
    {
        Self {
            type_name: type_name::<T>(),
            rewriter: Arc::new(rewriter),
        }
    }

    pub fn type_name(&self) -> &'static str {
        self.type_name
    }
}

#[async_trait]
impl UrlRewriter for ReqwestUrlRewriter {
    async fn rewrite(&self, url: Url) -> Result<Url, ApiError> {
        self.rewriter.rewrite(url).await
    }
}