shrek-deck 0.1.4

A crate for making TTS custom deck objects
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

#![warn(clippy::pedantic)]
#![warn(clippy::nursery)]
// #[cfg(feature = "parser")]
pub mod parser;
#[cfg(feature = "tts")]
pub mod tts;

use serde::{Deserialize, Serialize};
use std::fmt::Display;
#[cfg(feature = "tts")]
use tts::{CardShape, CustomDeckState};
use uuid::Uuid;

#[derive(Clone, Debug, PartialEq, Eq, Serialize, Deserialize)]
pub enum CardError {
    CardDoesntExist {
        card_name: String,
    },
    BackImageFileError {
        card_name: String,
        image_url: String,
    },
    FrontImageNotFound {
        card_name: String,
        image_url: String,
    },
    Custom {
        message: String,
    },
}

impl Display for CardError {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Self::CardDoesntExist { card_name } => write!(f, "Card doesn't exist: {card_name}"),
            Self::BackImageFileError {
                card_name,
                image_url,
            } => write!(
                f,
                "Couldn't find the file for {card_name}'s back: {image_url}"
            ),
            Self::FrontImageNotFound {
                card_name,
                image_url,
            } => write!(
                f,
                "Couldn't find the file for {card_name}'s front: {image_url}"
            ),
            Self::Custom { message } => write!(f, "{message}"),
        }
    }
}

impl CardError {
    #[must_use]
    pub const fn custom(message: String) -> Self {
        Self::Custom { message }
    }
}

/// Trait for all things that are cards
pub trait GetCardInfo: Sized {
    /// The card's name
    fn get_name(&self) -> &str;
    /// The card's front image URL
    /// # Errors
    /// Whenever you decide
    fn get_front_image(&self) -> Result<String, CardError>;
    /// The card's back image URL
    /// # Errors
    /// Whenever you decide
    fn get_back_image(&self) -> Result<String, CardError>;
    /// The card shape
    /// # Errors
    /// Whenever you decide
    #[cfg(feature = "tts")]
    fn get_card_shape(&self) -> Result<CardShape, CardError>;
    /// Turns a String into a card.
    /// # Errors
    /// Whenever you decide
    // #[cfg(feature="parser")]
    fn parse(string: &str) -> Result<Self, parser::ParseError>;
}

#[derive(Clone)]
pub struct CardEntry<T: GetCardInfo + Clone> {
    pub card: T,
    pub amount: i64,
}

#[cfg(feature = "tts")]
impl<T: GetCardInfo + Clone> CardEntry<T> {
    /// # Errors
    /// Whenever any of the `GetCardInfo` implementations in the supplied type error.
    pub fn get_custom_deck_state(&self) -> Result<CustomDeckState, CardError> {
        Ok(CustomDeckState {
            name: self.card.get_name().to_owned(),
            face_url: self.card.get_front_image()?,
            back_url: self.card.get_back_image()?,
            num_width: Some(1),
            num_height: Some(1),
            back_is_hidden: true,
            unique_back: false,
            r#type: self.card.get_card_shape()?.into(),
        })
    }
}

#[cfg(feature = "tts")]
fn generate_guid() -> String {
    Uuid::new_v4().to_string()
}