some-random-api 0.3.0

An asynchronous API wrapper for Some Random API.
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

use crate::{
    AnimalEndpoint, AnimuEndpoint, CanvasEndpoint, CanvasFilterEndpoint, CanvasMiscEndpoint,
    CanvasOverlayEndpoint, ChatBotEndpoint, FactEndpoint, ImageEndpoint, OthersEndpoint,
    PokemonEndpoint, PremiumEndpoint, Requester, WelcomeEndpoint,
};

/// A struct with functions used for interacting with Some Random API
pub struct Client {
    pub animal: AnimalEndpoint,
    pub animu: AnimuEndpoint,
    pub canvas: CanvasEndpoint,
    pub chatbot: ChatBotEndpoint,
    pub fact: FactEndpoint,
    pub image: ImageEndpoint,
    pub others: OthersEndpoint,
    pub pokemon: PokemonEndpoint,
    pub premium: PremiumEndpoint,
    pub welcome: WelcomeEndpoint,
}

impl Client {
    /// Constructs a new [`Client`]
    ///
    /// # Examples
    ///
    /// ```
    /// use some_random_api::Client;
    ///
    /// // A client without an API key
    /// Client::new(None::<String>);
    ///
    /// // A client with an API key
    /// Client::new(Some("xxxxxxxxxx"));
    /// ```
    pub fn new<T: ToString>(api_key: Option<T>) -> Self {
        let requester = Requester::new(api_key);

        Self {
            animal: AnimalEndpoint(requester.clone()),
            animu: AnimuEndpoint(requester.clone()),
            canvas: CanvasEndpoint {
                filter: CanvasFilterEndpoint(requester.clone()),
                misc: CanvasMiscEndpoint(requester.clone()),
                overlay: CanvasOverlayEndpoint(requester.clone()),
            },
            chatbot: ChatBotEndpoint(requester.clone()),
            fact: FactEndpoint(requester.clone()),
            image: ImageEndpoint(requester.clone()),
            others: OthersEndpoint(requester.clone()),
            pokemon: PokemonEndpoint(requester.clone()),
            premium: PremiumEndpoint(requester.clone()),
            welcome: WelcomeEndpoint(requester),
        }
    }
}