mangadex 0.1.2

Unofficial asynchronous mangadex API wrapper for rust
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
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141

//! Cover art

use std::borrow::Cow;

use derive_builder::Builder;
use reqwest::multipart::Form;
use reqwest::multipart::Part;
use reqwest::Method;
use serde::Serialize;
use uuid::Uuid;

use crate::common::Endpoint;
use crate::schema::{cover::*, NoData};
use crate::Client;
use crate::Result;

/// Cover art list
///
/// Call to `GET /cover`
#[derive(Debug, Serialize, Clone, Builder, Default)]
#[builder(default, setter(strip_option))]
pub struct ListCovers<'a> {
    /// Page size (max 100)
    pub limit: Option<i32>,

    /// Page offset (max ~10k)
    pub offset: Option<i32>,

    /// Manga ids (max 100)
    #[builder(setter(each = "add_manga"))]
    pub manga: Vec<&'a Uuid>,

    /// Cover ids (max 100)
    #[serde(rename = "ids")]
    #[builder(setter(each = "add_cover"))]
    pub covers: Vec<&'a Uuid>,

    /// Uploader ids (max 100)
    #[builder(setter(each = "add_uploader"))]
    pub uploaders: Vec<&'a Uuid>,

    /// Sort order
    pub order: Option<CoverOrder>,
}

impl_endpoint! {
    GET "/cover",
    #[query] ListCovers<'_>,
    CoverList
}

/// Get cover
///
/// Call to `GET /cover/{cover_id}`
#[derive(Debug, Clone)]
pub struct GetCover<'a> {
    pub cover_id: &'a Uuid,
}

impl_endpoint! {
    GET ("/cover/{:x}", cover_id),
    #[no_data] GetCover<'_>,
    #[flatten_result] CoverResponse
}

/// Edit cover
///
/// Call to `PUT /cover/{cover_id}`
#[derive(Debug, Serialize, Clone)]
pub struct EditCover<'a> {
    /// Cover id
    #[serde(skip)]
    pub cover_id: &'a Uuid,

    /// Cover volume
    pub volume: Option<&'a str>,

    /// Cover description
    pub description: Option<&'a str>,

    /// Cover version
    pub version: i32,
}

impl_endpoint! {
    PUT ("/cover/{:x}", cover_id),
    #[body auth] EditCover<'_>,
    #[flatten_result] CoverResponse
}

/// Delete cover
///
/// Call to `DELETE /cover/{cover_id}`
pub struct DeleteCover<'a> {
    pub cover_id: &'a Uuid,
}

impl_endpoint! {
    DELETE ("/cover/{:x}", cover_id),
    #[no_data auth] DeleteCover<'_>,
    #[discard_result] Result<NoData>
}

/// Upload cover (requires authentication)
///
/// Call to `POST /cover/{manga_id}`
pub struct UploadCover<'a> {
    /// Manga id
    pub manga_id: &'a Uuid,

    /// Image bytes
    pub image_bytes: Cow<'static, [u8]>,
}

impl Endpoint for UploadCover<'_> {
    type Query = ();
    type Body = ();
    type Response = CoverResponse;

    fn path(&self) -> Cow<str> {
        Cow::Owned(format!("/cover/{:x}", self.manga_id))
    }
    fn method(&self) -> Method {
        Method::POST
    }

    fn require_auth(&self) -> bool {
        true
    }

    fn multipart(&self) -> Option<Form> {
        let part = Part::bytes(self.image_bytes.clone());
        Some(Form::new().part("file", part))
    }
}

impl UploadCover<'_> {
    pub async fn send(&self, client: &Client) -> CoverResponse {
        client.send_request(self).await?
    }
}