imdb-async 0.5.0

Opinionated and unopinionated async wrappers to efficiently retrieve and parse IMDB's dataset
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

use serde::Deserialize;
use serde::Serialize;

#[derive(Debug, Deserialize, Eq, PartialEq, Serialize)]
/// Represents a "link" between an episode and a series.
pub struct EpisodeLink {
	/// ID of the episode
	pub imdb_id: u64,
	/// ID of the series to which the episode belongs
	pub series_imdb_id: u64,
	pub season: Option<u16>,
	pub episode: Option<u16>
}

// TODO:  Can we do this in a better way?  Maybe seperate Deserialize impls for CSV vs bincode?  Is there even any harm in doing this way, performance or otherwise?
impl From<EpisodeLinkFromImdb> for EpisodeLink {
	fn from(input: EpisodeLinkFromImdb) -> Self {
		Self{
			imdb_id: input.imdb_id,
			series_imdb_id: input.series_imdb_id,
			season: input.season,
			// There are a couple entries in tt0417331 with insane (>65535) episode numbers; we're going to explicitly ignore those here and let the overflow be truncated.
			episode: input.episode.map(|i| i as u16)
		}
	}
}

impl EpisodeLink {
	#[allow(dead_code)] // Used in tests
	pub(crate) fn new(imdb_id: u64, series_imdb_id: u64, season: Option<u16>, episode: Option<u16>) -> Self {
		Self{
			imdb_id,
			series_imdb_id,
			season,
			episode
		}
	}
}

#[derive(Debug, Deserialize, Eq, PartialEq)]
pub(crate) struct EpisodeLinkFromImdb {
	#[serde(rename = "tconst", deserialize_with = "crate::util::parse_imdb_id")]
	pub imdb_id: u64,
	#[serde(rename = "parentTconst", deserialize_with = "crate::util::parse_imdb_id")]
	pub series_imdb_id: u64,
	#[serde(rename = "seasonNumber", deserialize_with = "crate::util::parse_janky_tsv_option")]
	pub season: Option<u16>,
	#[serde(rename = "episodeNumber", deserialize_with = "crate::util::parse_janky_tsv_option_u32")]
	pub episode: Option<u32>
}