ticketmeister 0.1.2

A lightweight and intuitive library for accessing ticket master api in 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

mod enums;
mod structs;

pub use self::enums::*;
pub use self::structs::*;

use api_request_utils_rs::{
    RequestInfo,
    RequestModifiers,
    RequestDefaults,
    RequestHandler,

    ErrorHandler,
    
    reqwest::{
        Client,
        RequestBuilder,
    },

    serde_json::Value
};


/// The Inventory Status API provides event status for primary Ticketmaster inventory with inventory updates happening near real-time.
pub struct Inventory<'a> {
    client : Client,
    api_key : &'a str,
    error_handler : &'a ErrorHandler<()>
}

impl RequestInfo for Inventory<'_> {
    const BASE_URL : &'static str = "https://app.ticketmaster.com/inventory-status/v1";
    fn client(&self) -> &Client {
        &self.client
    }
}

impl RequestModifiers for Inventory<'_> {}

impl RequestDefaults for Inventory<'_> {     
    fn default_parameters(&self,request_builder: RequestBuilder) -> RequestBuilder {
        request_builder.query(&[("apikey", self.api_key)])
    }
}

impl RequestHandler for Inventory<'_> {}

impl<'a> Inventory<'a> {
    /// Creates a new `Inventory` instance.
    ///
    /// This method takes an API key and an error handler, and initializes
    /// a `Client` instance internally for making API requests.
    pub fn new(api_key: &'a str, error_handler: &'a ErrorHandler<()>) -> Self {
        let client = Client::new();
        Self::new_with_client(client, api_key, error_handler)
    }

    /// Creates a new `Inventory` instance with a specific `Client` instance.
    ///
    /// This method allows you to provide a pre-existing `Client` instance for making API requests,
    /// along with an API key and an error handler.
    pub fn new_with_client(client: Client, api_key: &'a str, error_handler: &'a ErrorHandler<()>) -> Self {
        Self {
            client,
            api_key,
            error_handler,
        }
    }

    /// Retrieves the inventory status for a list of event IDs.
    ///
    /// This method performs an API request to retrieve the inventory status for the specified event IDs.
    /// It takes a slice of event IDs and returns an optional `InventoryStatus` indicating the status of the inventory.
    pub async fn inventory_status(&self, event_ids: &[u32]) -> Option<InventoryStatus> {
        let parameters = std::collections::HashMap::from([("track_isrc", Value::from(event_ids))]);
        self.get_request_handler::<InventoryStatus, ()>("availability", &parameters, self.error_handler).await
    }
}