ts_io/
base64.rs

1//! Bytes that (de)serialize to `unpadded base64url`.
2
3use core::ops::{Deref, DerefMut};
4
5use base64ct::{Base64UrlUnpadded, Encoding};
6
7/// Bytes that (de)serialize to `unpadded base64url`.
8#[derive(Clone, PartialEq, Eq)]
9pub struct Base64Url(pub Vec<u8>);
10
11impl Base64Url {
12    /// Encode as `unpadded base64url`.
13    pub fn encode(&self) -> String {
14        Base64UrlUnpadded::encode_string(self)
15    }
16
17    /// Decode `unpadded base64url`.
18    pub fn decode(base64: &str) -> Option<Self> {
19        Base64UrlUnpadded::decode_vec(base64).map(Self).ok()
20    }
21
22    /// Get the underlying bytes as a slice.
23    pub fn as_slice(&self) -> &[u8] {
24        self.as_ref()
25    }
26}
27
28impl Deref for Base64Url {
29    type Target = [u8];
30
31    fn deref(&self) -> &Self::Target {
32        self.as_ref()
33    }
34}
35impl DerefMut for Base64Url {
36    fn deref_mut(&mut self) -> &mut Self::Target {
37        self.as_mut()
38    }
39}
40
41impl AsRef<[u8]> for Base64Url {
42    fn as_ref(&self) -> &[u8] {
43        &self.0
44    }
45}
46impl AsMut<[u8]> for Base64Url {
47    fn as_mut(&mut self) -> &mut [u8] {
48        &mut self.0
49    }
50}
51
52impl core::fmt::Debug for Base64Url {
53    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
54        f.debug_tuple("Base64").field(&self.encode()).finish()
55    }
56}
57
58impl PartialEq<[u8]> for Base64Url {
59    fn eq(&self, other: &[u8]) -> bool {
60        self.as_slice().eq(other)
61    }
62}
63
64impl From<Vec<u8>> for Base64Url {
65    fn from(value: Vec<u8>) -> Self {
66        Self(value)
67    }
68}
69
70#[cfg(feature = "serde")]
71impl<'de> serde::Deserialize<'de> for Base64Url {
72    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
73    where
74        D: serde::Deserializer<'de>,
75    {
76        let base64: &str = serde::Deserialize::deserialize(deserializer)?;
77        Self::decode(base64).ok_or_else(|| serde::de::Error::custom("invalid unpadded base64url"))
78    }
79}
80
81#[cfg(feature = "serde")]
82impl serde::Serialize for Base64Url {
83    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
84    where
85        S: serde::Serializer,
86    {
87        serializer.serialize_str(&self.encode())
88    }
89}
ts_io/base64.rs

ts_io/
base64.rs
