merde_time/
lib.rs

1//! Provides [Rfc3339], a wrapper around [time::OffsetDateTime] that implements
2//! [merde_core::Serialize] and [merde_core::Deserialize] when the right
3//! cargo features are enabled.
4
5use std::{
6    fmt,
7    ops::{Deref, DerefMut},
8};
9
10pub use time::OffsetDateTime;
11
12/// A wrapper around date-time types that implements `Serialize` and `Deserialize`
13/// when the right cargo features are enabled.
14#[derive(Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
15#[repr(transparent)]
16pub struct Rfc3339<T>(pub T);
17
18impl<T> From<T> for Rfc3339<T> {
19    fn from(t: T) -> Self {
20        Rfc3339(t)
21    }
22}
23
24impl<T> Deref for Rfc3339<T> {
25    type Target = T;
26
27    fn deref(&self) -> &T {
28        &self.0
29    }
30}
31
32impl<T> DerefMut for Rfc3339<T> {
33    fn deref_mut(&mut self) -> &mut T {
34        &mut self.0
35    }
36}
37
38impl<T> fmt::Debug for Rfc3339<T>
39where
40    T: fmt::Debug,
41{
42    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
43        self.0.fmt(f)
44    }
45}
46
47impl<T> fmt::Display for Rfc3339<T>
48where
49    T: fmt::Display,
50{
51    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
52        self.0.fmt(f)
53    }
54}
55
56#[cfg(feature = "merde")]
57mod merde_impls {
58    use super::*;
59
60    impl merde_core::IntoStatic for Rfc3339<OffsetDateTime> {
61        type Output = Rfc3339<OffsetDateTime>;
62
63        fn into_static(self) -> Self::Output {
64            self
65        }
66    }
67
68    #[cfg(feature = "deserialize")]
69    impl<'s> merde_core::Deserialize<'s> for Rfc3339<time::OffsetDateTime> {
70        async fn deserialize<D>(de: &mut D) -> Result<Self, D::Error<'s>>
71        where
72            D: merde_core::Deserializer<'s> + ?Sized,
73        {
74            let s = merde_core::CowStr::deserialize(de).await?;
75            Ok(Rfc3339(
76                time::OffsetDateTime::parse(
77                    s.as_ref(),
78                    &time::format_description::well_known::Rfc3339,
79                )
80                .map_err(|_| merde_core::MerdeError::InvalidDateTimeValue)?,
81            ))
82        }
83    }
84
85    #[cfg(feature = "serialize")]
86    impl merde_core::Serialize for Rfc3339<time::OffsetDateTime> {
87        async fn serialize<S>(&self, serializer: &mut S) -> Result<(), S::Error>
88        where
89            S: merde_core::Serializer + ?Sized,
90        {
91            let s = self
92                .0
93                .format(&time::format_description::well_known::Rfc3339)
94                .unwrap();
95            serializer
96                .write(merde_core::Event::Str(merde_core::CowStr::Borrowed(&s)))
97                .await
98        }
99    }
100}
101
102#[cfg(all(test, feature = "full"))]
103mod tests {
104    use super::*;
105    use merde_json::{from_str, JsonSerialize};
106    use time::macros::datetime;
107
108    #[test]
109    fn test_rfc3339_offset_date_time_roundtrip() {
110        let original = Rfc3339(datetime!(2023-05-15 14:30:00 UTC));
111        let serialized = original.to_json_string().unwrap();
112        let deserialized: Rfc3339<time::OffsetDateTime> = from_str(&serialized).unwrap();
113        assert_eq!(original, deserialized);
114    }
115
116    #[test]
117    fn test_rfc3339_offset_date_time_serialization() {
118        let dt = Rfc3339(datetime!(2023-05-15 14:30:00 UTC));
119        let serialized = dt.to_json_string().unwrap();
120        assert_eq!(serialized, r#""2023-05-15T14:30:00Z""#);
121    }
122
123    #[test]
124    fn test_rfc3339_offset_date_time_deserialization() {
125        let json = r#""2023-05-15T14:30:00Z""#;
126        let deserialized: Rfc3339<time::OffsetDateTime> = from_str(json).unwrap();
127        assert_eq!(deserialized, Rfc3339(datetime!(2023-05-15 14:30:00 UTC)));
128    }
129}
merde_time/lib.rs

merde_time/
lib.rs
