tmdb-rs 1.0.4

Async, fully-typed TMDB (API v3 + v4) client with compile-time append_to_response
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

use serde::Deserialize;
use strum::Display;
use time::Date;

use crate::endpoints::movie::MovieShort;
use crate::endpoints::person::PersonShort;
use crate::endpoints::tv::TvShort;
use crate::{Language, Poster, Still};

/// the database an external id comes from
#[derive(Debug, Clone, Copy, PartialEq, Eq, Display)]
pub enum ExternalSource {
    #[strum(serialize = "imdb_id")]
    Imdb,
    #[strum(serialize = "tvdb_id")]
    Tvdb,
    #[strum(serialize = "facebook_id")]
    Facebook,
    #[strum(serialize = "instagram_id")]
    Instagram,
    #[strum(serialize = "threads_id")]
    Threads,
    #[strum(serialize = "tiktok_id")]
    Tiktok,
    #[strum(serialize = "twitter_id")]
    Twitter,
    #[strum(serialize = "wikidata_id")]
    Wikidata,
    #[strum(serialize = "youtube_id")]
    Youtube,
}

/// one season found by external id
#[derive(Debug, Clone, Deserialize)]
pub struct FoundSeason {
    pub id: u64,
    pub show_id: u64,
    pub name: String,
    pub season_number: u32,
    #[serde(default, deserialize_with = "crate::common::opt_date")]
    pub air_date: Option<Date>,
    #[serde(rename = "poster_path")]
    pub poster: Option<Poster>,
}

/// one episode found by external id
#[derive(Debug, Clone, Deserialize)]
pub struct FoundEpisode {
    pub id: u64,
    pub show_id: u64,
    pub name: String,
    pub episode_number: u32,
    pub season_number: u32,
    #[serde(default, deserialize_with = "crate::common::opt_date")]
    pub air_date: Option<Date>,
    #[serde(rename = "still_path")]
    pub still: Option<Still>,
    pub vote_average: f64,
    pub vote_count: u32,
}

/// everything matching one external id
#[derive(Debug, Clone, Default, Deserialize)]
#[serde(default)]
pub struct FindResults {
    pub movie_results: Vec<MovieShort>,
    pub tv_results: Vec<TvShort>,
    pub person_results: Vec<PersonShort>,
    pub tv_episode_results: Vec<FoundEpisode>,
    pub tv_season_results: Vec<FoundSeason>,
}

endpoint! {
    /// find TMDB entries by an external id (imdb, tvdb, wikidata, ...)
    find(external_id: &str, external_source: ExternalSource): GET "/find/{external_id}" => FindResults {
        params { language: Language }
    }
}