steamkit-rs 0.1.2

Rust port of SteamKit2, a .NET library that aims to interoperate with the Steam network.
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

//! Making Web API interfaces from a `SteamConfiguration`.

use crate::steam::steam_client::configuration::steam_configuration::{
    HttpClientPurpose, SteamConfiguration,
};

use super::web_api::{AsyncInterface, Interface};

/// Makes Web API interfaces from a `SteamConfiguration`. The free functions
/// [`get_web_api_interface`] and [`get_async_web_api_interface`] do the same
/// without the trait.
pub trait SteamConfigurationWebApiExtensions {
    /// An interface for calling the given Web API interface.
    fn get_web_api_interface(&self, iface: &str) -> Interface;

    /// An async interface for calling the given Web API interface.
    fn get_async_web_api_interface(&self, iface: &str) -> AsyncInterface;
}

impl SteamConfigurationWebApiExtensions for SteamConfiguration {
    /// An interface for calling the given Web API interface.
    fn get_web_api_interface(&self, iface: &str) -> Interface {
        Interface::new(
            get_http_client_for_web_api(self),
            self.web_api_base_address().clone(),
            iface,
            self.web_api_key(),
        )
    }

    /// An async interface for calling the given Web API interface.
    fn get_async_web_api_interface(&self, iface: &str) -> AsyncInterface {
        AsyncInterface::new(
            get_http_client_for_web_api(self),
            self.web_api_base_address().clone(),
            iface,
            self.web_api_key(),
        )
    }
}

/// An interface for calling the given Web API interface.
pub fn get_web_api_interface(config: &SteamConfiguration, iface: &str) -> Interface {
    Interface::new(
        get_http_client_for_web_api(config),
        config.web_api_base_address().clone(),
        iface,
        config.web_api_key(),
    )
}

/// An async interface for calling the given Web API interface.
pub fn get_async_web_api_interface(config: &SteamConfiguration, iface: &str) -> AsyncInterface {
    AsyncInterface::new(
        get_http_client_for_web_api(config),
        config.web_api_base_address().clone(),
        iface,
        config.web_api_key(),
    )
}

/// The HTTP client a configuration's Web API interfaces use.
///
/// A `reqwest::Client` can't be reconfigured after it's built, so the base
/// address lives on the interface and the timeout is applied per request. A
/// timeout set by the factory itself isn't overridden.
pub(crate) fn get_http_client_for_web_api(config: &SteamConfiguration) -> reqwest::Client {
    let factory = config.http_client_factory();

    factory(HttpClientPurpose::WebAPI)
}