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
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

use serde::Deserialize;

use crate::endpoints::person::PersonShort;
use crate::{Backdrop, Poster, Profile, Still};

#[derive(Debug, Clone, Deserialize)]
pub struct CastMember {
    pub name: String,
    pub character: Option<String>,
    #[serde(rename = "profile_path")]
    pub profile: Option<Profile>,
    pub order: Option<u32>,
    pub credit_id: String,
}

#[derive(Debug, Clone, Deserialize)]
pub struct CrewMember {
    pub name: String,
    pub job: String,
    pub department: String,
    #[serde(rename = "profile_path")]
    pub profile: Option<Profile>,
    pub credit_id: String,
}

#[derive(Debug, Clone, Deserialize)]
pub struct Credits {
    pub cast: Vec<CastMember>,
    pub crew: Vec<CrewMember>,
}

/// one season credited on an episode-level credit
#[derive(Debug, Clone, Deserialize)]
pub struct CreditSeason {
    pub season_number: u32,
    pub name: String,
    #[serde(rename = "poster_path")]
    pub poster: Option<Poster>,
    pub air_date: Option<String>,
}

/// one episode credited on an episode-level credit
#[derive(Debug, Clone, Deserialize)]
pub struct CreditEpisode {
    pub id: u64,
    pub name: String,
    pub episode_number: u32,
    pub season_number: u32,
    pub air_date: Option<String>,
    #[serde(rename = "still_path")]
    pub still: Option<Still>,
    pub overview: Option<String>,
}

/// the movie a credit points at
#[derive(Debug, Clone, Deserialize)]
pub struct CreditMovie {
    pub id: u64,
    #[serde(rename = "title")]
    pub name: String,
    #[serde(rename = "original_title")]
    pub original_name: String,
    #[serde(rename = "poster_path")]
    pub poster: Option<Poster>,
    #[serde(rename = "backdrop_path")]
    pub backdrop: Option<Backdrop>,
}

/// the series a credit points at
#[derive(Debug, Clone, Deserialize)]
pub struct CreditSeries {
    pub id: u64,
    pub name: String,
    pub original_name: String,
    #[serde(rename = "poster_path")]
    pub poster: Option<Poster>,
    #[serde(rename = "backdrop_path")]
    pub backdrop: Option<Backdrop>,
    #[serde(default)]
    pub seasons: Vec<CreditSeason>,
    #[serde(default)]
    pub episodes: Vec<CreditEpisode>,
    pub character: Option<String>,
}

/// the movie or series a credit points at, discriminated by TMDB's `media_type`
#[derive(Debug, Clone, Deserialize)]
#[serde(tag = "media_type", rename_all = "snake_case")]
pub enum CreditMedia {
    Movie(CreditMovie),
    Tv(CreditSeries),
}

/// cast (on screen) or crew (behind it)
#[derive(Debug, Clone, Copy, PartialEq, Eq, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum CreditType {
    Cast,
    Crew,
}

/// a single credit by its credit id
#[derive(Debug, Clone, Deserialize)]
pub struct CreditDetails {
    pub id: String,
    pub credit_type: CreditType,
    pub department: String,
    pub job: String,
    pub media: CreditMedia,
    pub person: PersonShort,
}

endpoint! {
    /// a credit by its credit id
    credit(id: &str): GET "/credit/{id}" => CreditDetails
}