3 unstable releases
0.2.0 | Mar 29, 2020 |
---|---|
0.1.1 | Aug 13, 2018 |
0.1.0 | Aug 6, 2018 |
#6 in #gathering
89KB
2K
SLoC
MTG-API Client
Rust Wrapper around the https://magicthegathering.io/ API
In-depth documentation about the capabilities can be found here: https://docs.magicthegathering.io/
This Wrapper supplies the related methods to call the API and the conversion of the supplied json data into rust objects.
Documentation
Documentation can be found on docs.rs: https://docs.rs/mtgapi-client
Integration
# Cargo.toml
[dependencies]
mtgapi-client = "0.1"
# main.rs / lib.rs
extern crate mtgapi_client;
Usage
// Create a client with the specified (per request) timeout
use mtgapi_client::MtgClient;
let api = MtgClient::new(100);
Example: Get all Cards on pages 20 - 25
The Page size for cards requests is 100 cards by default.
// Create a unfiltered cards request
let mut get_cards_request = api.cards().all();
//Start at Page 20
get_cards_request.set_page(20);
let mut cards: Vec<CardDetail> = Vec::new();
//collect all cards from pages 20 to 25
for _ in 0..5 {
let response = get_cards_request.next_page().await?
let cards = response.content;
if cards.is_empty() {
break;
}
unfiltered_cards.extend(cards);
}
println!("Unfiltered Cards: {:?}", unfiltered_cards);
Example: Get all cards matching a filter
// Create a filtered cards request
let mut get_cards_request = api.cards().all_filtered(
CardFilter::builder()
.game_format(GameFormat::Standard)
.cardtypes_or(&[CardType::Instant, CardType::Sorcery])
.converted_mana_cost(2)
.rarities(&[CardRarity::Rare, CardRarity::MythicRare])
.build(),
);
let mut cards: Vec<CardDetail> = Vec::new();
//collect all cards matching the filter
loop {
let response = get_cards_request.next_page().await?
let cards = response.content;
if cards.is_empty() {
break;
}
filtered_cards.extend(cards);
}
println!("Filtered Cards: {:?}", filtered_cards);
Some example API-calls
// Get all sets
let sets = api.sets().all().await?.content;
println!("All Sets: {:?}", sets);
// Get an example booster pack from the specified set
let booster_cards = api.sets().booster("ktk").await?.content;
println!("Random Cards from Booster: {:?}", booster_cards);
// Get all card types
let types = api.types().all().await?.content;
println!("Types: {:?}", types);
// Get all card subtypes
let subtypes = api.subtypes().all().await?.content;
println!("Subtypes: {:?}", subtypes);
// Get all card supertypes
let supertypes = api.supertypes().all().await?.content;
println!("Supertypes: {:?}", supertypes);
// Get all game formats
let formats = api.formats().all().await?.content;
println!("Formats: {:?}", formats);
Dependencies
~24MB
~564K SLoC