bubblehearth 0.1.0

Blizzard Game Data API bindings for 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
79
80
81
82
83
84
85

//! Hearthstone card APIs for searching and retrieving cards and card backs.

use serde::{Deserialize, Serialize};

use crate::errors::BubbleHearthResult;
use crate::hearthstone::card_search::CardSearchQuery;
use crate::hearthstone::HearthstoneConnector;
use crate::BubbleHearthId;

/// A generalized cards response for all Hearthstone card-based responses.
#[derive(Default, Debug, Clone, PartialEq, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Cards {
    /// Cards based on the card search results.
    pub cards: Vec<Card>,
    /// Number of cards in the search result.
    pub card_count: BubbleHearthId,
    /// Number of pages based on the search result.
    pub page_count: BubbleHearthId,
    /// Current page of the search results.
    pub page: BubbleHearthId,
}

/// A card with all associated Hearthstone metadata for the result.
#[derive(Default, Debug, Clone, PartialEq, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct Card {
    /// ID of the card.
    pub id: BubbleHearthId,
    pub collectible: BubbleHearthId,
    pub slug: String,
    pub class_id: BubbleHearthId,
    pub multi_class_ids: Vec<BubbleHearthId>,
    pub spell_school_id: Option<BubbleHearthId>,
    pub card_type_id: BubbleHearthId,
    pub card_set_id: BubbleHearthId,
    pub rarity_id: BubbleHearthId,
    pub artist_name: String,
    pub mana_cost: BubbleHearthId,
    pub name: String,
    pub text: String,
    pub image: String,
    pub image_gold: String,
    pub flavor_text: String,
    pub crop_image: String,
    pub keyword_ids: Vec<BubbleHearthId>,
    pub duels: Option<Duels>,
    pub copy_of_card_id: Option<BubbleHearthId>,
    pub health: Option<BubbleHearthId>,
    pub attack: Option<BubbleHearthId>,
    pub minion_type_id: Option<BubbleHearthId>,
    pub child_ids: Option<Vec<BubbleHearthId>>,
    pub rune_cost: Option<RuneCost>,
}

#[derive(Default, Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Duels {
    pub relevant: bool,
    pub constructed: bool,
}

#[derive(Default, Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct RuneCost {
    pub blood: i64,
    pub frost: i64,
    pub unholy: i64,
}

impl<'a> HearthstoneConnector<'a> {
    /// Searches for cards fronts and back based on the provided search criteria.
    pub async fn search_cards(
        &self,
        _query: Option<CardSearchQuery<'a>>,
    ) -> BubbleHearthResult<Cards> {
        let cards: Cards = self
            .client
            .send_request_and_deserialize(format!(
                "https://us.api.blizzard.com/hearthstone/cards?locale={}",
                self.client.locale.get_normalized_locale()
            ))
            .await?;

        Ok(cards)
    }
}