uefi: time: add unit test helpers for external crate integrations

Author: phip1611

uefi/src/runtime/time_defs/integration_common.rs

@@ -74,3 +74,107 @@ impl Error for ConversionErrorInner {
         }
     }
 }
+
+#[cfg(test)]
+#[allow(unused)]
+pub(super) mod test_helpers {
+    use super::*;
+    use crate::runtime::TimeParams;
+    use uefi::runtime::Time;
+    use uefi_raw::time::Daylight;
+
+    pub fn sample_time(tz: i16) -> Time {
+        let params = TimeParams {
+            year: 2024,
+            month: 3,
+            day: 14,
+            hour: 12,
+            minute: 34,
+            second: 56,
+            nanosecond: 123_456_789,
+            time_zone: Some(tz),
+            daylight: Daylight::default(),
+        };
+        Time::new(params).unwrap()
+    }
+
+    fn invalid_date() -> Time {
+        let mut t = sample_time(0);
+        t.0.month = 2;
+        t.0.day = 31;
+        t
+    }
+
+    pub fn primitive_roundtrip<T>()
+    where
+        T: TryFrom<Time, Error = ConversionError> + TryInto<Time, Error = ConversionError>,
+    {
+        let t = sample_time(Time::UNSPECIFIED_TIMEZONE);
+
+        let dt: T = t.try_into().unwrap();
+        let back: Time = dt.try_into().unwrap();
+
+        assert_eq!(back.0.year, t.0.year);
+        assert_eq!(back.0.month, t.0.month);
+        assert_eq!(back.0.day, t.0.day);
+        assert_eq!(back.0.hour, t.0.hour);
+        assert_eq!(back.0.minute, t.0.minute);
+        assert_eq!(back.0.second, t.0.second);
+        assert_eq!(back.0.nanosecond, t.0.nanosecond);
+    }
+
+    pub fn zoned_roundtrip<T>()
+    where
+        T: TryFrom<Time, Error = ConversionError> + TryInto<Time, Error = ConversionError>,
+    {
+        let t = sample_time(120);
+
+        let dt: T = t.try_into().unwrap();
+        let back: Time = dt.try_into().unwrap();
+
+        assert_eq!(back.0.time_zone, 120);
+        assert_eq!(back.0.hour, t.0.hour);
+        assert_eq!(back.0.minute, t.0.minute);
+    }
+
+    pub fn negative_offset_roundtrip<T>()
+    where
+        T: TryFrom<Time, Error = ConversionError> + TryInto<Time, Error = ConversionError>,
+    {
+        let t = sample_time(-330);
+
+        let dt: T = t.try_into().unwrap();
+        let back: Time = dt.try_into().unwrap();
+
+        assert_eq!(back.0.time_zone, -330);
+    }
+
+    pub fn preserves_nanoseconds<T>()
+    where
+        T: TryFrom<Time, Error = ConversionError> + TryInto<Time, Error = ConversionError>,
+    {
+        let t = sample_time(60);
+
+        let dt: T = t.try_into().unwrap();
+        let back: Time = dt.try_into().unwrap();
+
+        assert_eq!(back.0.nanosecond, 123_456_789);
+    }
+
+    pub fn unspecified_timezone_fails<T>()
+    where
+        T: TryFrom<Time, Error = ConversionError>,
+    {
+        let t = sample_time(Time::UNSPECIFIED_TIMEZONE);
+        let result: Result<T, _> = t.try_into();
+        assert!(result.is_err());
+    }
+
+    pub fn invalid_calendar_date_fails<T>()
+    where
+        T: TryFrom<Time, Error = ConversionError>,
+    {
+        let result: Result<T, _> = invalid_date().try_into();
+        assert!(result.is_err());
+    }
+}