ruipay 0.0.1

Ruipay - Mini thirdpart client 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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

use serde::Serialize;

use crate::{request::{LabraResponse, LabraRequest}, session::{SessionStore, SimpleStorage}, LabradorResult, RequestMethod, RequestType, Method};

/// API請求
#[derive(Debug, Clone)]
pub struct APIClient<T: SessionStore> {
    pub app_key: String,
    pub secret: String,
    pub api_path: String,
    pub session: T,
}

/// APIClient
/// 
/// Custom Client's Way
/// 
/// # Examples
/// ```no_run
/// use labrador::{APIClient, SessionStore};
/// struct DemoClient<T: SessionStore> {
///     api_client: APIClient<T>,
/// }
///
/// api_client.request()
/// ```
/// 
#[allow(unused)]
impl<T: SessionStore> APIClient<T> {

    /// # Init the client
    /// 
    /// `app_key` - ThirdPlatform Assign.
    /// `secret` - ThirdPlatform Assign.
    /// `api_path` - ThirdPlatform Url.
    ///
    #[inline]
    pub fn new<Q: Into<String>, S: Into<String>, R: Into<String>>(app_key: Q, secret: R, api_path: S) -> APIClient<SimpleStorage> {
        APIClient {
            app_key: app_key.into(),
            secret: secret.into(),
            api_path: api_path.into(),
            session: SimpleStorage::new()
        }
    }

    #[inline]
    pub fn from_session<Q: Into<String>, S: Into<String>, R: Into<String>>(app_key: Q, secret: R, api_path: S, session: T) -> APIClient<T> {
        APIClient {
            app_key: app_key.into(),
            secret: secret.into(),
            api_path: api_path.into(),
            session: session,
        }
    }

    pub fn session(&self) -> &T {
        &self.session
    }

    /// Request Http/Https
    ///
    /// # Examples
    ///
    /// ```no_run
    /// use labrador::APIClient;
    /// use serde_json::json;
    /// use labrador::Method;
    /// use labrador::{LabraRequest, LabradorResult};
    /// use std::error::Error;
    /// async fn main() -> LabradorResult<(), Error> {
    ///     let api = APIClient::new("appkey", "secret", "http_url");
    ///     let params = vec![(String::from("key"), String::from("value"))];
    ///     let data = json!({
    ///         "key": "value"
    ///     });
    ///     api.request(LabraRequest::new().method(Method::Post).data(data).req_type(request_type).params(params)).await?;
    /// }
    /// ```
    ///
    #[inline]
    pub async fn request<D: Serialize>(&self, mut req: LabraRequest<D>) -> LabradorResult<LabraResponse> {
        let mut api_path = self.api_path.to_owned();
        let LabraRequest { url, ..} = req;
        if url.starts_with("http") {
            req.url = url;
        } else {
            req.url = api_path + &url;
        }
        req.request().await
    }

    /// 发送POST请求
    pub async fn post<D: Serialize, R: RequestMethod>(&self, method: R, mut querys: Vec<(String, String)>, data: D, request_type: RequestType) -> LabradorResult<LabraResponse> {
        let req = LabraRequest::new().url(method.get_method()).params(querys).method(Method::Post).json(data).req_type(request_type);
        self.request(req).await
    }

    /// 发送GET请求
    pub async fn get<R: RequestMethod>(&self, method: R, params: Vec<(String, String)>, request_type: RequestType) -> LabradorResult<LabraResponse> {
        let req = LabraRequest::<String>::new().url(method.get_method()).params(params).method(Method::Get).req_type(request_type);
        self.request(req).await
    }
}