lta 0.6.0

🚍 Singapore LTA Datamall Rust Client written in pure rust with support for asynchronous requests
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

//! Client for interacting with LTA API
use crate::blocking::Client;
use crate::{LTAError, LTAResult};
use reqwest::blocking::Client as BlockingClient;
use reqwest::blocking::RequestBuilder;

/// A `Client` to make requests with
/// The `Client` holds a connection pool internally, so it is advised that you create one and reuse it
/// There are some instance where you might need to customise your client due to certain limitations.
///
/// The `Client` trait has a general constructor method and you should use the `reqwest` re-export
/// to build you own customised client from the ground up.
///
/// Take a look at the reqwest documentation on how to build your own client
///
/// ## Example
/// ```rust
/// use lta::reqwest::blocking::ClientBuilder;
/// use lta::blocking::client::LTAClient;
/// use lta::Client;
/// use std::time::Duration;
///
///
/// fn my_custom_client() -> LTAClient {
///     let client = ClientBuilder::new()
///         .no_gzip()
///         .connect_timeout(Duration::new(420, 0))
///         .build()
///         .unwrap();
///
///     LTAClient::new(String::from("API_KEY"), client)
/// }
/// ```
#[derive(Debug, Clone)]
pub struct LTAClient {
    api_key: String,
    client: BlockingClient,
}

impl Client for LTAClient {
    type InternalClient = BlockingClient;
    type RB = RequestBuilder;

    fn new(api_key: impl Into<String>, client: Self::InternalClient) -> LTAClient {
        let api_key = api_key.into();
        LTAClient { api_key, client }
    }

    fn with_api_key(api_key: impl Into<String>) -> LTAResult<Self> {
        let api_key = api_key.into();

        if api_key.is_empty() {
            return Err(LTAError::InvalidAPIKey);
        }
        
        let client = BlockingClient::new();
        Ok(LTAClient { api_key, client })
    }

    fn req_builder(&self, url: &str) -> Self::RB {
        self.client
            .get(url)
            .header("AccountKey", self.api_key.as_str())
    }
}