mangadex 0.1.2

Unofficial asynchronous mangadex API wrapper for rust
Documentation
use crate::{common::deserialize_null_default, errors::Result};
use chrono::{DateTime, Utc};
use derive_builder::Builder;
use serde::{Deserialize, Serialize};
use serde_with::skip_serializing_none;
use std::collections::HashMap;
use uuid::Uuid;

use super::{ApiData, ApiObject, LocalizedString, OrderType, Results};

/// The tag mode.
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Hash, PartialEq, Eq)]
#[serde(rename_all = "UPPERCASE")]
pub enum TagMode {
    // AND Mode
    And,
    // OR Mode
    Or,
}

#[derive(Debug, Serialize, Deserialize, Clone, PartialEq, Eq)]
#[serde(rename_all = "camelCase")]
pub struct TagAttributes {
    pub name: LocalizedString,
    // TODO: Known issue: empty descriptions return [] instead of {}
    #[serde(skip)]
    pub description: LocalizedString,
    pub group: String,
    pub version: i32,
}

/// The status of a manga.
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Hash, PartialEq, Eq)]
#[serde(rename_all = "lowercase")]
pub enum MangaStatus {
    Ongoing,
    Completed,
    Hiatus,
    Cancelled,
}

/// The publication demographic.
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Hash, PartialEq, Eq)]
#[serde(rename_all = "lowercase")]
pub enum Demographic {
    Shounen,
    Shoujo,
    Josei,
    Seinen,
    None,
}

/// The content rating of the publication.
#[derive(Debug, Serialize, Deserialize, Clone, Copy, Hash, PartialEq, Eq)]
#[serde(rename_all = "lowercase")]
pub enum ContentRating {
    Safe,
    Suggestive,
    Erotica,
    Pornographic,
}

#[derive(Debug, Serialize, Deserialize, Clone, Hash, PartialEq, Eq)]
#[serde(rename_all = "camelCase")]
pub enum MangaOrder {
    CreatedAt(OrderType),
    UpdatedAt(OrderType),
}

pub type Links = HashMap<String, String>;

#[derive(Debug, Serialize, Deserialize, Clone)]
#[serde(rename_all = "camelCase")]
pub struct MangaAttributes {
    pub title: LocalizedString,
    pub alt_titles: Vec<LocalizedString>,
    // TODO: Known issue: empty descriptions return [] instead of {}
    #[serde(skip)]
    pub description: LocalizedString,
    #[serde(deserialize_with = "deserialize_null_default")]
    pub links: Links,
    pub original_language: String,
    pub last_volume: Option<String>,
    pub last_chapter: Option<String>,
    pub publication_demographic: Option<Demographic>,
    pub status: Option<MangaStatus>,
    /// Year of release
    pub year: Option<i32>,
    pub content_rating: Option<ContentRating>,
    pub tags: Vec<Tag>,
    pub version: i32,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

#[skip_serializing_none]
#[derive(Debug, Builder, Default, Serialize, Deserialize, Clone)]
#[serde(rename_all = "camelCase")]
#[builder(setter(into, strip_option))]
pub struct MangaRequest {
    pub title: LocalizedString,

    #[builder(default)]
    pub alt_titles: Option<Vec<LocalizedString>>,

    #[builder(default)]
    pub description: Option<LocalizedString>,

    #[builder(default)]
    pub authors: Option<Vec<Uuid>>,

    #[builder(default)]
    pub artists: Option<Vec<Uuid>>,

    #[builder(default)]
    pub links: Option<Links>,

    #[builder(default)]
    pub original_language: Option<String>,

    #[builder(default)]
    pub last_volume: Option<String>,

    #[builder(default)]
    pub last_chapter: Option<String>,

    #[builder(default)]
    pub publication_demographic: Option<Demographic>,

    #[builder(default)]
    pub status: Option<MangaStatus>,

    /// Year of release
    #[builder(default)]
    pub year: Option<i32>,

    #[builder(default)]
    pub content_rating: Option<ContentRating>,

    #[builder(default)]
    pub mod_notes: Option<String>,

    pub version: i32,
}

#[derive(Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct MangaReadingStatuses {
    pub statuses: HashMap<Uuid, MangaReadingStatus>,
}

#[derive(Debug, Serialize, Deserialize, Clone)]
#[serde(rename_all = "snake_case")]
pub enum MangaReadingStatus {
    Reading,
    OnHold,
    PlanToRead,
    Dropped,
    ReReading,
    Completed,
}

#[derive(Debug, Deserialize, Clone)]
#[serde(rename_all = "camelCase")]
pub struct MangaReadingStatusBody {
    pub status: MangaReadingStatus,
}

#[derive(Debug, Deserialize, Clone)]
pub struct ChapterAggregate {
    chapter: String,
    count: i32,
}

#[derive(Debug, Deserialize, Clone)]
pub struct VolumeAggregate {
    volume: String,
    count: i32,
    chapters: HashMap<String, ChapterAggregate>,
}

#[derive(Debug, Deserialize, Clone)]
pub struct MangaAggregate {
    volumes: HashMap<String, VolumeAggregate>,
}

pub type MangaAggregateResponse = Result<MangaAggregate>;

pub type Tag = ApiObject<TagAttributes>;
pub type TagResponse = Result<ApiData<Tag>>;
pub type TagList = Vec<TagResponse>;

pub type Manga = ApiObject<MangaAttributes>;
pub type MangaResponse = Result<ApiData<Manga>>;
pub type MangaList = Results<MangaResponse>;

pub type MangaReadMarkers = Vec<Uuid>;
pub type MangaReadMarkerResponse = Result<ApiData<MangaReadMarkers>>;