pkstate 0.1.2

A library for representing, serializing, and deserializing the state of a poker hand
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

use cardpack::prelude::{BasicPile, Pile, Standard52};
use serde::{Deserialize, Deserializer, Serializer};

/// Custom serializer to convert `BasicPile` to string
///
/// # Errors
///
/// This function will return an error if the `BasicPile` cannot be converted to a string,
/// which should not happen under normal circumstances since `BasicPile` implements `ToString`.
pub fn serialize_basic_pile<S>(pile: &BasicPile, serializer: S) -> Result<S::Ok, S::Error>
where
    S: Serializer,
{
    serializer.serialize_str(&pile.to_string())
}

/// Custom deserializer to convert string back to `BasicPile`
///
/// # Errors
///
/// This function will return an error if the string cannot be parsed into a `Pile<Standard52>`,
/// which can happen if the string is not in the correct format or contains invalid card representations.
pub fn deserialize_basic_pile<'de, D>(deserializer: D) -> Result<BasicPile, D::Error>
where
    D: Deserializer<'de>,
{
    let s = String::deserialize(deserializer)?;

    let pile = s
        .parse::<Pile<Standard52>>()
        .map_err(serde::de::Error::custom)?;
    Ok(pile.into_basic_pile())
}

/// Custom serializer to convert `Option<BasicPile>` to string
///
/// # Errors
///
/// This function will return an error if the `BasicPile` cannot be converted to a string,
pub fn serialize_basic_pile_opt<S>(
    pile: &Option<BasicPile>,
    serializer: S,
) -> Result<S::Ok, S::Error>
where
    S: Serializer,
{
    match pile {
        Some(p) => serializer.serialize_str(&p.to_string()),
        None => serializer.serialize_none(),
    }
}

/// Custom deserializer to convert string back to` Option<BasicPile>`
///
/// # Errors
///
/// This function will return an error if the string cannot be parsed into a `Pile<Standard52>`,
pub fn deserialize_basic_pile_opt<'de, D>(deserializer: D) -> Result<Option<BasicPile>, D::Error>
where
    D: Deserializer<'de>,
{
    let opt = Option::<String>::deserialize(deserializer)?;
    match opt {
        Some(s) => s
            .parse::<Pile<Standard52>>()
            .map(|p| p.into_basic_pile())
            .map(Some)
            .map_err(serde::de::Error::custom),
        None => Ok(None),
    }
}