lunar-lib 0.11.1

Common utilities for lunar applications
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

use std::fmt;

use rand::{
    RngExt,
    distr::{Distribution, StandardUniform},
};

#[derive(Debug)]
#[cfg_attr(
    feature = "serde",
    derive(serde::Serialize, serde::Deserialize),
    serde(transparent)
)]
pub struct Id<T: ?Sized>(
    #[serde(with = "hex::serde")] [u8; 32],
    std::marker::PhantomData<T>,
);
pub const ID_SIZE: usize = 32;

impl<T> Id<T> {
    #[must_use]
    pub fn cast<U>(self) -> Id<U> {
        Id::<U>(self.0, std::marker::PhantomData)
    }

    #[must_use]
    pub fn generate() -> Id<T> {
        rand::rng().random()
    }
}

impl<T> Distribution<Id<T>> for StandardUniform {
    fn sample<R: rand::Rng + ?Sized>(&self, rng: &mut R) -> Id<T> {
        Id(rng.random(), std::marker::PhantomData)
    }
}

impl<T> Clone for Id<T> {
    fn clone(&self) -> Self {
        *self
    }
}

impl<T> Copy for Id<T> {}

impl<T> PartialEq for Id<T> {
    fn eq(&self, other: &Self) -> bool {
        self.0 == other.0
    }
}

impl<T> Eq for Id<T> {}

impl<T> std::hash::Hash for Id<T> {
    fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
        self.0.hash(state);
    }
}

impl<T> fmt::Display for Id<T> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        hex::encode(self.0).fmt(f)
    }
}

impl<T> std::str::FromStr for Id<T> {
    type Err = hex::FromHexError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        let mut id = [0u8; 32];
        hex::decode_to_slice(s, &mut id)?;
        Ok(Self(id, std::marker::PhantomData))
    }
}

impl<T> hex::FromHex for Id<T> {
    type Error = hex::FromHexError;

    fn from_hex<T1: AsRef<[u8]>>(hex: T1) -> Result<Self, Self::Error> {
        let id = <[u8; 32]>::from_hex(hex)?;
        Ok(Self(id, std::marker::PhantomData))
    }
}

impl<T> AsRef<[u8]> for Id<T> {
    fn as_ref(&self) -> &[u8] {
        &self.0
    }
}

impl<T> std::ops::Deref for Id<T> {
    type Target = [u8; 32];

    fn deref(&self) -> &Self::Target {
        &self.0
    }
}

impl<T> From<[u8; 32]> for Id<T> {
    fn from(value: [u8; 32]) -> Self {
        Self(value, std::marker::PhantomData)
    }
}

impl<T> From<Id<T>> for [u8; 32] {
    fn from(value: Id<T>) -> Self {
        value.0
    }
}

impl<T> TryFrom<Vec<u8>> for Id<T> {
    type Error = std::array::TryFromSliceError;

    fn try_from(value: Vec<u8>) -> Result<Self, Self::Error> {
        Self::try_from(&*value)
    }
}

impl<T> TryFrom<&[u8]> for Id<T> {
    type Error = std::array::TryFromSliceError;

    fn try_from(value: &[u8]) -> Result<Self, Self::Error> {
        let value: [u8; 32] = value.try_into()?;
        Ok(Self(value, std::marker::PhantomData))
    }
}