jomini 0.34.1

Low level, performance oriented parser for save and game files from EU4, CK3, HOI4, Vic3, Imperator, and other PDS titles
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

#[cfg(feature = "serde")]
use crate::{
    Error,
    binary::{TokenResolver, de::BinaryDeserializerBuilder},
};

/// Trait customizing decoding values from binary data
///
/// How binary data is encoded differs between games and even
/// between patches!
pub trait BinaryFlavor: crate::Encoding {
    /// Decode a f32 from 4 bytes of data
    fn visit_f32(&self, data: [u8; 4]) -> f32;

    /// Decode a f64 from 8 bytes of data
    fn visit_f64(&self, data: [u8; 8]) -> f64;

    /// Create binary deserializer from this binary flavor
    #[cfg(feature = "serde")]
    fn deserializer(&self) -> BinaryDeserializerBuilder<&Self>
    where
        Self: Sized,
    {
        BinaryDeserializerBuilder::with_flavor(self)
    }

    /// Deserialize value from slice of data with this binary flavor
    #[cfg(feature = "serde")]
    fn deserialize_slice<'de, 'res: 'de, T, RES>(
        &self,
        data: &'de [u8],
        resolver: &'res RES,
    ) -> Result<T, Error>
    where
        T: serde::de::Deserialize<'de>,
        RES: TokenResolver,
        Self: Sized,
    {
        self.deserializer().deserialize_slice(data, resolver)
    }

    /// Deserialize value from stream of data with this binary flavor
    #[cfg(feature = "serde")]
    fn deserialize_reader<T, RES, R>(&self, reader: R, resolver: &RES) -> Result<T, Error>
    where
        T: serde::de::DeserializeOwned,
        RES: TokenResolver,
        R: std::io::Read,
        Self: Sized,
    {
        self.deserializer().deserialize_reader(reader, resolver)
    }
}

impl<T: BinaryFlavor + ?Sized> BinaryFlavor for &'_ T {
    fn visit_f32(&self, data: [u8; 4]) -> f32 {
        (**self).visit_f32(data)
    }

    fn visit_f64(&self, data: [u8; 8]) -> f64 {
        (**self).visit_f64(data)
    }
}

impl<T: BinaryFlavor + ?Sized> BinaryFlavor for Box<T> {
    fn visit_f32(&self, data: [u8; 4]) -> f32 {
        (**self).visit_f32(data)
    }

    fn visit_f64(&self, data: [u8; 8]) -> f64 {
        (**self).visit_f64(data)
    }
}