anilist_moe 0.4.0

Anilist_Moe is a Rust Wrapper for the Anilist API. This library allows you to seamlessly interact with Anilist's Public API with and without authentication. This currently supports Anime, Manga, Users, Staff, Forum, Threads, Recommendations, Reviews and User Activities
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
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

use crate::enums::character::CharacterSort;
use crate::enums::media::MediaSort;
use crate::errors::AniListError;
use crate::objects::character::Character;
use crate::objects::responses::Page;
use crate::{client::AniListClient, queries::character};
use serde::{Deserialize, Serialize};
use serde_with::skip_serializing_none;

/// Options for fetching multiple characters with pagination and filters.
#[skip_serializing_none]
#[derive(Default, Debug, Serialize, Deserialize)]
pub struct FetchCharacterOptions {
    pub page: Option<i32>,
    pub id: Option<i32>,
    #[serde(rename = "perPage")]
    pub per_page: Option<i32>,
    pub search: Option<String>,
    pub sort: Option<Vec<CharacterSort>>,
    #[serde(rename = "isBirthday")]
    pub is_birthday: Option<bool>,
    pub id_not: Option<i32>,
    pub id_in: Option<Vec<i32>>,
    pub id_not_in: Option<Vec<i32>>,
    // Extra
    #[serde(rename = "includeMedia")]
    pub include_media: Option<bool>,
    #[serde(rename = "includeModNotes")]
    pub include_mod_notes: Option<bool>,
    // Sub-pagination variables
    #[serde(rename = "mediaSort")]
    pub media_sort: Option<Vec<MediaSort>>,
    #[serde(rename = "mediaPage")]
    pub media_page: Option<i32>,
    #[serde(rename = "mediaPerPage")]
    pub media_per_page: Option<i32>,
}

/// Options for fetching a single character.
#[skip_serializing_none]
#[derive(Default, Debug, Serialize, Deserialize)]
pub struct FetchCharacterOneOptions {
    pub id: Option<i32>,
    #[serde(rename = "isBirthday")]
    pub is_birthday: Option<bool>,
    pub search: Option<String>,
    pub id_not: Option<i32>,
    pub id_in: Option<Vec<i32>>,
    pub id_not_in: Option<Vec<i32>>,
    pub sort: Option<Vec<CharacterSort>>,
    pub page: Option<i32>,
    #[serde(rename = "perPage")]
    pub per_page: Option<i32>,
    // Sub-pagination variables
    #[serde(rename = "mediaSort")]
    pub media_sort: Option<Vec<MediaSort>>,
    #[serde(rename = "mediaPage")]
    pub media_page: Option<i32>,
    #[serde(rename = "mediaPerPage")]
    pub media_per_page: Option<i32>,
}

/// Endpoint for character operations.
pub struct CharacterEndpoint {
    client: AniListClient,
}

impl CharacterEndpoint {
    pub fn new(client: AniListClient) -> Self {
        Self { client }
    }

    pub async fn fetch(
        &self,
        options: &FetchCharacterOptions,
    ) -> Result<Page<Vec<Character>>, AniListError> {
        let query = character::FETCH;
        self.client.fetch(query, Some(options)).await
    }

    pub async fn fetch_one(
        &self,
        options: &FetchCharacterOneOptions,
    ) -> Result<Character, AniListError> {
        let query = character::FETCH_ONE;
        self.client.fetch(query, Some(options)).await
    }

    // Convenience functions

    /// Get popular characters sorted by favorites
    pub async fn get_popular(
        &self,
        page: Option<i32>,
        per_page: Option<i32>,
    ) -> Result<Page<Vec<Character>>, AniListError> {
        self.fetch(&FetchCharacterOptions {
            page,
            per_page,
            sort: Some(vec![CharacterSort::FavouritesDesc]),
            ..Default::default()
        })
        .await
    }

    /// Get most favorited characters (alias for get_popular)
    pub async fn get_most_favorited(
        &self,
        page: Option<i32>,
        per_page: Option<i32>,
    ) -> Result<Page<Vec<Character>>, AniListError> {
        self.get_popular(page, per_page).await
    }

    /// Search characters by name
    pub async fn search(
        &self,
        query: &str,
        page: Option<i32>,
        per_page: Option<i32>,
    ) -> Result<Page<Vec<Character>>, AniListError> {
        self.fetch(&FetchCharacterOptions {
            search: Some(query.to_string()),
            page,
            per_page,
            sort: Some(vec![CharacterSort::SearchMatch]),
            ..Default::default()
        })
        .await
    }

    /// Get character by ID
    pub async fn get_by_id(&self, id: i32) -> Result<Character, AniListError> {
        self.fetch_one(&FetchCharacterOneOptions {
            id: Some(id),
            ..Default::default()
        })
        .await
    }

    /// Get characters with birthday today
    pub async fn get_today_birthday(
        &self,
        page: Option<i32>,
        per_page: Option<i32>,
    ) -> Result<Page<Vec<Character>>, AniListError> {
        self.fetch(&FetchCharacterOptions {
            is_birthday: Some(true),
            page,
            per_page,
            sort: Some(vec![CharacterSort::FavouritesDesc]),
            ..Default::default()
        })
        .await
    }
}