steam-rs 0.5.1

Safe Rust bindings for the Steam Web 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
56
57
58
59
60

use std::collections::HashMap;

use serde::{Deserialize, Serialize};

use crate::{
    errors::{ErrorHandle, SteamUserStatsError},
    macros::{do_http, gen_args},
    steam_id::SteamId,
    Steam,
};

const END_POINT: &str = "https://api.steampowered.com/ISteamUserStats/GetUserStatsForGame/v1";

#[derive(Debug, Clone, Deserialize, Serialize)]
pub enum UserGameStats {
    #[serde(rename = "playerstats")]
    PlayerStats {
        #[serde(rename = "steamID")]
        /// TODO: Make this SteamId
        steam_id: String,
        #[serde(rename = "gameName")]
        game_name: String,
        achievements: HashMap<String, Achievement>,
        stats: HashMap<String, Stat>,
    },
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct Achievement {
    pub apiname: Option<String>,
    pub achieved: u8,
    /// TODO: Reconsider this
    pub unlocktime: Option<u64>,
}

#[derive(Debug, Clone, Deserialize, Serialize)]
pub struct Stat {
    pub value: u64,
}

impl Steam {
    /// This end point gives a 1:1 output of the api, if you were to put the endpoint into a browser, expect the same layout
    /// ( carbon-copy )
    pub async fn get_user_stats_for_game(
        &self,
        steamid: SteamId,
        appid: u32,
    ) -> Result<UserGameStats, SteamUserStatsError> {
        let key = &self.api_key.clone();
        let steamid = steamid.into_u64();
        let args = gen_args!(key, appid, steamid);
        let url = format!("{END_POINT}?{args}");
        Ok(do_http!(
            url,
            UserGameStats,
            ErrorHandle,
            SteamUserStatsError::GetUserStatsForGame
        ))
    }
}