krabdex 0.1.0

A type-safe, async Rust SDK for the PokeAPI
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

use serde::{Deserialize, Serialize};
use serde_json::Value;

use crate::models::common::{NamedApiResource, VersionGameIndex};

/// PokeAPI Pokémon resource.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct Pokemon {
    pub id: u32,
    pub name: String,
    pub base_experience: Option<u32>,
    pub height: u32,
    pub weight: u32,
    pub is_default: bool,
    pub order: u32,

    pub abilities: Vec<PokemonAbility>,
    pub forms: Vec<NamedApiResource>,
    pub game_indices: Vec<VersionGameIndex>,
    pub held_items: Vec<HeldItem>,
    pub location_area_encounters: String,
    pub moves: Vec<PokemonMove>,
    pub species: NamedApiResource,
    pub stats: Vec<PokemonStat>,
    pub types: Vec<PokemonTypeSlot>,

    #[serde(default)]
    pub past_types: Vec<PastType>,

    #[serde(default)]
    pub past_abilities: Vec<PastAbility>,

    /// Explicitly acknowledged but not modeled.
    /// This preserves the full payload without schema explosion.
    pub sprites: Value,

    #[serde(default)]
    pub cries: Option<PokemonCries>,
}

/* ---------- Abilities ---------- */

/// Ability info attached to a Pokémon.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct PokemonAbility {
    pub is_hidden: bool,
    pub slot: u8,
    pub ability: Option<NamedApiResource>,
}

/* ---------- Held Items ---------- */

/// Held item details.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct HeldItem {
    pub item: NamedApiResource,
    pub version_details: Vec<HeldItemVersionDetail>,
}

/// Held item details per version.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct HeldItemVersionDetail {
    pub rarity: u32,
    pub version: NamedApiResource,
}

/* ---------- Moves ---------- */

/// Move entry on a Pokémon.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct PokemonMove {
    #[serde(rename = "move")]
    pub move_: NamedApiResource,
    pub version_group_details: Vec<MoveVersionGroupDetail>,
}

/// Move details per version group.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct MoveVersionGroupDetail {
    pub level_learned_at: u32,
    pub move_learn_method: NamedApiResource,
    pub version_group: NamedApiResource,
}

/* ---------- Stats ---------- */

/// Stat entry for a Pokémon.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct PokemonStat {
    pub base_stat: u32,
    pub effort: u32,
    pub stat: NamedApiResource,
}

/* ---------- Types ---------- */

/// Type slot info (includes slot number).
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct PokemonTypeSlot {
    pub slot: u8,

    #[serde(rename = "type")]
    pub ty: NamedApiResource,
}

/* ---------- Past Types ---------- */

/// Historical type assignments for a Pokémon.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct PastType {
    pub generation: NamedApiResource,
    pub types: Vec<PokemonTypeSlot>,
}

/* ---------- Past Abilities ---------- */

/// Historical ability assignments for a Pokémon.
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct PastAbility {
    pub generation: NamedApiResource,
    pub abilities: Vec<PokemonAbility>,
}

/* ---------- Cries (newer field) ---------- */

/// Pokémon cries (latest and legacy).
#[derive(Debug, Clone, PartialEq, Deserialize, Serialize)]
pub struct PokemonCries {
    pub latest: String,
    #[serde(default)]
    pub legacy: Option<String>,
}