5 releases (3 breaking)

0.4.0 May 1, 2024
0.3.1 Mar 25, 2024
0.3.0 Nov 15, 2023
0.2.0 Aug 16, 2022
0.1.0 Aug 8, 2022

#1663 in Web programming

Apache-2.0

21KB
339 lines

steamr 🦀

crates.io Documentation Apache-2 licensed CI

steamr is a simple Rust library to help you to interact with Valve's Steam API. It uses the reqwest crate under the hood.

Requirements

You need a valid API key to make full use of this library. Visit https://steamcommunity.com/dev/apikey to obtain yours.

Example

use steamr::client::SteamClient;
use steamr::errors::SteamError;

fn main() -> Result<(), SteamError> {
    // Create a new client that will be used to communicate with Steam's API.
    let api_key = String::from("your-api-key");
    let steam_client = SteamClient::from(api_key);

    // Get a list of all games from the user with the provided Steam ID (given that they are publicly visible)
    let steam_id = "some-steam-id";
    let steam_lib = steam_client.get_library(&steam_id)?;

    // Print out the games that were played for more than an hour.
    steam_lib.games.iter()
        .filter(|g| g.playtime_forever > 60)
        .for_each(|g| println!("{}", g.name));

    Ok(())
}

There are some endpoints that don't require an API key. If you only need those, you can use SteamClient like so:

use steamr::client::SteamClient;
use steamr::errors::SteamError;

fn main() -> Result<(), SteamError> {
    // Create a new SteamClient without an API key
    let steam_client = SteamClient::new();

    // Get news for a game
    let app_id = "10";
    let news = steam_client.get_game_news(app_id, 5, 100)?;
    news.game_news.iter()
        .for_each(|n| println!("The article '{}' was written by '{}'", n.title, n.author));

    Ok(())
}

Dependencies

~4–15MB
~197K SLoC