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
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
//! # Non-Official Internet Game Database Api Client written in Rust
//!
//! With igdb you can easily retrieve video game related information such as:
//!
//! Games, Franchises, Videos, Artworks, Covers, Screenshots, Release Dates, Multiplayer Options, Game Engines, Websites and much more!.
//!
//! Use out of the box client methods or build your own queries to retrieve the exact data that you are looking for.
//!
//!
//! ## Links
//! [Repository]
//!
//! [README]
//!
//! [IGDB Site]
//!
//! [IGDB Api]
//!
//! [Repository]: https://github.com/Hukadan/igdb
//! [IGDB Site]: https://github.com/TyOverby/bincode
//! [IGDB Api]: https://api-docs.igdb.com/#endpoints
//! [examples]: https://github.com/Hukadan/igdb/tree/master/examples
//! [README]: https://github.com/Hukadan/igdb/blob/develop/README.md
//!
//! ## Code Examples
//! You can check some code samples here: [examples]
//!
//! ## Examples
//!
//! **Get game by name**
//!
//! ```no_run
//!use async_std::task;
//!use igdb::client::IGDBClient;
//!
//!task::block_on(async {
//! let games_client = IGDBClient::new("client_id", "token").games();
//! let games_results = games_client.get_by_name("Borderlands", 10).await.unwrap();
//!
//! for game in games_results {
//! println!("Name: {}", game.name);
//! println!("Story line: {}", game.storyline);
//! println!("Url: {}", game.url);
//! }
//!
//! // Name: The Witcher 3: Wild Hunt - Hearts of Stone
//! // Summary: Hired by the Merchant of Mirrors, Geralt is tasked with overcoming Olgierd von Everec -- a ruthless bandit captain enchanted with the power of immorta ...
//! // Story line: Professional monster slayer is hired to deal with a ruthless bandit captain who possesses the power of immortality.
//! // Url: https://www.igdb.com/games/the-witcher-3-wild-hunt-hearts-of-stone
//!
//!})
//!```
//!
//! **Get games by name**
//!
//!```no_run
//!use async_std::task;
//!use igdb::client::IGDBClient;
//!
//! task::block_on(async {
//! let games_client = IGDBClient::new("client_id", "token").games();
//! // Get ten first games containing word Borderlands
//! let games_results = games_client.get_by_name("Borderlands", 10).await.unwrap();
//!
//! for game in games_results {
//! println!("Name: {}", game.name);
//! println!("Story line: {}", game.storyline);
//! println!("Url: {}", game.url);
//! }
//!
//! // Name: Borderlands: The Pre-Sequel - Lady Hammerlock The Baroness
//! // Story line:
//! // Url: https://www.igdb.com/games/borderlands-the-pre-sequel-lady-hammerlock-the-baroness
//! // Name: Borderlands Legends
//! // Story line:
//! // Url: https://www.igdb.com/games/borderlands-legends
//! // Name: Tales from the Borderlands: Episode 3 - Catch a Ride
//! // Story line:
//! // Url: https://www.igdb.com/games/tales-from-the-borderlands-episode-3-catch-a-ride
//! // Name: Borderlands 2: Game of the Year Edition
//!
//! // Omitted for brevity...
//! })
//!```
//!
//! **Game release date**
//!
//!```no_run
//!use async_std::task;
//!use igdb::client::IGDBClient;
//!
//! task::block_on(async {
//! let igdb_client = IGDBClient::new("client_id", "token");
//!
//! let release_client = igdb_client.release_dates();
//!
//! //Get releases for Borderlands3 with id 19164
//! let releases = release_client.get_by_game_id(19164, 10).await.unwrap();
//!
//! let platform_client = igdb_client.platforms();
//!
//! for release in releases {
//! let platform = platform_client
//! .get_first_by_id(release.platform as usize)
//! .await
//! .unwrap();
//!
//! println!(
//! "platform: {} release date: {}",
//! platform.name, release.human
//! );
//! }
//!
//! // platform: Xbox One release date: 2019-Sep-13
//! // platform: PC (Microsoft Windows) release date: 2019-Sep-13
//! // platform: PlayStation 4 release date: 2019-Sep-13
//! // platform: Google Stadia release date: 2019-Sep-13
//! })
//!```
//!
//! **Download Screenshots and Covers for a game**
//!
//! ```no_run
//!
//!use async_std::task;
//!use igdb::client::IGDBClient;
//!use igdb::media_quality::MediaQuality;
//!
//!
//! task::block_on(async {
//! let igdb_client = IGDBClient::new("client_id", "token");
//! let games_client = igdb_client.games();
//! let witcher = games_client.get_first_by_name("Witcher 3").await.unwrap();
//!
//! //Get the first 3 covers for the Witcher 3 game
//! let covers_client = igdb_client.covers();
//! let covers_response = covers_client.get_by_game_id(witcher.id, 3).await.unwrap();
//!
//! //Get the first 3 screenshots for the Witcher 3 game
//! let screenshots_client = igdb_client.screenshots();
//! let screenshots_response = screenshots_client
//! .get_by_game_id(witcher.id, 3)
//! .await
//! .unwrap();
//!
//! for (i, cover) in covers_response.iter().enumerate() {
//! covers_client
//! .download_by_id(
//! cover.id,
//! format!("cover{}.jpg", i),
//! MediaQuality::ScreenshotHuge,
//! )
//! .await
//! .unwrap();
//! }
//!
//! for (i, screenshot) in screenshots_response.iter().enumerate() {
//! screenshots_client
//! .download_by_id(
//! screenshot.id,
//! format!("screenshot{}.jpg", i),
//! MediaQuality::CoverBig,
//! )
//! .await
//! .unwrap();
//! }
//! })
//! ```
//!
//! **You can read more samples here: [examples]**
extern crate serde_derive;
type Error = ;