mangadex_api/v5/manga/id/
delete.rs

1//! Builder for the delete manga endpoint.
2//!
3//! <https://api.mangadex.org/docs/swagger.html#/Manga/delete-manga-id>
4//!
5//! # Examples
6//!
7//! ```rust
8//! use uuid::Uuid;
9//!
10//! use mangadex_api::v5::MangaDexClient;
11//! // use mangadex_api_types::{Password, Username};
12//!
13//! # async fn run() -> anyhow::Result<()> {
14//! let client = MangaDexClient::default();
15//!
16//! /*
17//!     // Put your login script
18//!     let _login_res = client
19//!         .auth()
20//!         .login()
21//!         .post()
22//!         .username(Username::parse("myusername")?)
23//!         .password(Password::parse("hunter23")?)
24//!         .send()
25//!         .await?;
26//!  */
27//!
28//!
29//! let manga_id = Uuid::new_v4();
30//! let res = client
31//!     .manga()
32//!     .id(manga_id)
33//!     .delete()
34//!     .send()
35//!     .await?;
36//!
37//! println!("delete: {:?}", res);
38//! # Ok(())
39//! # }
40//! ```
41
42use derive_builder::Builder;
43use serde::Serialize;
44use uuid::Uuid;
45
46use crate::HttpClientRef;
47use mangadex_api_schema::NoData;
48
49#[cfg_attr(
50    feature = "deserializable-endpoint",
51    derive(serde::Deserialize, getset::Getters, getset::Setters)
52)]
53#[derive(Debug, Serialize, Clone, Builder)]
54#[serde(rename_all = "camelCase")]
55#[builder(
56    setter(into, strip_option),
57    build_fn(error = "mangadex_api_types::error::BuilderError")
58)]
59pub struct DeleteManga {
60    /// This should never be set manually as this is only for internal use.
61    #[doc(hidden)]
62    #[serde(skip)]
63    #[builder(pattern = "immutable")]
64    #[cfg_attr(feature = "deserializable-endpoint", getset(set = "pub", get = "pub"))]
65    pub http_client: HttpClientRef,
66
67    #[serde(skip_serializing)]
68    pub manga_id: Uuid,
69}
70
71endpoint! {
72    DELETE ("/manga/{}", manga_id),
73    #[no_data auth] DeleteManga,
74    #[rate_limited] NoData,
75    DeleteMangaBuilder
76}
77
78#[cfg(test)]
79mod tests {
80    use serde_json::json;
81    use url::Url;
82    use uuid::Uuid;
83    use wiremock::matchers::{header, method, path_regex};
84    use wiremock::{Mock, MockServer, ResponseTemplate};
85
86    use crate::v5::AuthTokens;
87    use crate::{HttpClient, MangaDexClient};
88
89    #[tokio::test]
90    async fn delete_manga_fires_a_request_to_base_url() -> anyhow::Result<()> {
91        let mock_server = MockServer::start().await;
92        let http_client = HttpClient::builder()
93            .base_url(Url::parse(&mock_server.uri())?)
94            .auth_tokens(AuthTokens {
95                session: "sessiontoken".to_string(),
96                refresh: "refreshtoken".to_string(),
97            })
98            .build()?;
99        let mangadex_client = MangaDexClient::new_with_http_client(http_client);
100
101        let manga_id = Uuid::new_v4();
102        let response_body = json!({
103            "result": "ok",
104        });
105
106        Mock::given(method("DELETE"))
107            .and(path_regex(r"/manga/[0-9a-fA-F-]+"))
108            .and(header("Authorization", "Bearer sessiontoken"))
109            .respond_with(
110                ResponseTemplate::new(200)
111                    .insert_header("x-ratelimit-retry-after", "1698723860")
112                    .insert_header("x-ratelimit-limit", "40")
113                    .insert_header("x-ratelimit-remaining", "39")
114                    .set_body_json(response_body),
115            )
116            .expect(1)
117            .mount(&mock_server)
118            .await;
119
120        mangadex_client.manga().id(manga_id).delete().send().await?;
121
122        Ok(())
123    }
124}