flix-tmdb 0.0.11

Clients and models for fetching data from TMDB
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

//! Episodes API

use core::time::Duration;
use std::rc::Rc;

use flix_model::numbers::{EpisodeNumber, SeasonNumber};

use governor::Jitter;

use crate::Config;
use crate::model::Episode;
use crate::model::id::ShowId;

use super::{Error, make_request};

/// TMDB Episodes API client
pub struct Client {
	config: Rc<Config>,
}

impl Client {
	/// Create a new client with the given configuration
	pub fn new(config: Rc<Config>) -> Self {
		Self { config }
	}
}

impl Client {
	/// Fetch the details of the episode refered to by ID, season number and episode number
	pub async fn get_details(
		&self,
		id: impl Into<ShowId>,
		season: impl Into<SeasonNumber>,
		episode: impl Into<EpisodeNumber>,
		language: Option<&str>,
	) -> Result<Episode, Error> {
		self.config
			.limiter
			.until_ready_with_jitter(Jitter::new(
				Duration::from_millis(0),
				Duration::from_millis(50),
			))
			.await;

		Ok(self
			.config
			.client
			.execute(make_request(
				&self.config,
				&format!(
					"/3/tv/{}/season/{}/episode/{}",
					id.into().into_raw(),
					season.into(),
					episode.into()
				),
				language,
			)?)
			.await?
			.error_for_status()?
			.json()
			.await?)
	}
}