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::common::StatusResponse;
use crate::endpoints::search::MultiResult;
use crate::{Language, Poster, SessionId};

/// the kind of items a v3 list holds
#[derive(Debug, Clone, Copy, PartialEq, Eq, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum ListType {
    Movie,
    Tv,
}

/// one list in a list-of-lists response
#[derive(Debug, Clone, Deserialize)]
pub struct ListShort {
    pub id: u64,
    pub name: String,
    pub description: String,
    pub item_count: u32,
    #[serde(rename = "iso_639_1")]
    pub language: Option<Language>,
    pub list_type: Option<ListType>,
    #[serde(rename = "poster_path")]
    pub poster: Option<Poster>,
    pub favorite: Option<bool>,
}

/// a v3 list and its items
#[derive(Debug, Clone, Deserialize)]
pub struct ListDetails {
    pub id: String,
    pub name: String,
    pub description: String,
    pub item_count: u32,
    #[serde(rename = "iso_639_1")]
    pub language: Option<Language>,
    pub list_type: Option<ListType>,
    #[serde(rename = "poster_path")]
    pub poster: Option<Poster>,
    pub favorite: bool,
    #[serde(default)]
    pub items: Vec<MultiResult>,
    #[serde(default)]
    pub total_pages: u32,
    #[serde(default)]
    pub total_results: u64,
    #[serde(default)]
    pub page: u32,
}

/// the answer of `item_status`
#[derive(Debug, Clone, Deserialize)]
pub struct ItemStatus {
    pub id: String,
    pub item_present: bool,
    pub media_type: Option<String>,
    pub media_id: Option<u64>,
}

/// the answer of a list creation
#[derive(Debug, Clone, Deserialize)]
pub struct CreateListResponse {
    pub success: bool,
    pub status_code: i32,
    pub status_message: String,
    pub list_id: Option<u64>,
}

endpoint! {
    /// a list and its items
    list(id: u64, session_id: SessionId): GET "/list/{id}" => ListDetails {
        params { language: Language, page: u32 }
    }
}

endpoint! {
    /// whether a title is on a list
    list_item_status(id: u64, session_id: SessionId): GET "/list/{id}/item_status" => ItemStatus {
        params { movie_id: u64 }
    }
}

endpoint! {
    /// create a list
    create_list(session_id: SessionId): POST "/list" => CreateListResponse {
        body { name: &str, description: &str, language: &str }
    }
}

endpoint! {
    /// add a title to a list
    list_add_item(id: u64, session_id: SessionId): POST "/list/{id}/add_item" => StatusResponse {
        body { media_id: u64 }
    }
}

endpoint! {
    /// remove a title from a list
    list_remove_item(id: u64, session_id: SessionId): POST "/list/{id}/remove_item" => StatusResponse {
        body { media_id: u64 }
    }
}

endpoint! {
    /// remove every title from a list
    list_clear(id: u64, session_id: SessionId): POST "/list/{id}/clear" => StatusResponse {
        body { confirm: bool }
    }
}

endpoint! {
    /// delete a list
    list_delete(id: u64, session_id: SessionId): DELETE "/list/{id}" => StatusResponse
}