tz/error/
mod.rs

1//! Error types.
2
3pub mod datetime;
4pub mod timezone;
5
6#[cfg(feature = "alloc")]
7pub mod parse;
8
9use datetime::DateTimeError;
10use timezone::{LocalTimeTypeError, TimeZoneError, TransitionRuleError};
11
12#[cfg(feature = "alloc")]
13use parse::{TzFileError, TzStringError};
14
15use core::error;
16use core::fmt;
17
18#[cfg(feature = "alloc")]
19use alloc::boxed::Box;
20
21/// Unified error type for everything in the crate
22#[non_exhaustive]
23#[derive(Debug)]
24pub enum Error {
25    /// I/O error
26    #[cfg(feature = "alloc")]
27    Io(Box<dyn error::Error + Send + Sync + 'static>),
28    /// Unified error type for every non I/O error in the crate
29    Tz(TzError),
30}
31
32impl fmt::Display for Error {
33    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
34        match self {
35            #[cfg(feature = "alloc")]
36            Self::Io(error) => error.fmt(f),
37            Self::Tz(error) => error.fmt(f),
38        }
39    }
40}
41
42impl error::Error for Error {}
43
44impl<T: Into<TzError>> From<T> for Error {
45    fn from(error: T) -> Self {
46        Self::Tz(error.into())
47    }
48}
49
50/// Unified error type for every non I/O error in the crate
51#[non_exhaustive]
52#[derive(Debug)]
53pub enum TzError {
54    /// Unified error for parsing a TZif file
55    #[cfg(feature = "alloc")]
56    TzFile(TzFileError),
57    /// Unified error for parsing a TZ string
58    #[cfg(feature = "alloc")]
59    TzString(TzStringError),
60    /// Local time type error
61    LocalTimeType(LocalTimeTypeError),
62    /// Transition rule error
63    TransitionRule(TransitionRuleError),
64    /// Time zone error
65    TimeZone(TimeZoneError),
66    /// Date time error
67    DateTime(DateTimeError),
68    /// Out of range operation
69    OutOfRange,
70    /// No available local time type
71    NoAvailableLocalTimeType,
72}
73
74impl fmt::Display for TzError {
75    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
76        match self {
77            #[cfg(feature = "alloc")]
78            Self::TzFile(error) => write!(f, "invalid TZ file: {error}"),
79            #[cfg(feature = "alloc")]
80            Self::TzString(error) => write!(f, "invalid TZ string: {error}"),
81            Self::LocalTimeType(error) => write!(f, "invalid local time type: {error}"),
82            Self::TransitionRule(error) => write!(f, "invalid transition rule: {error}"),
83            Self::TimeZone(error) => write!(f, "invalid time zone: {error}"),
84            Self::DateTime(error) => write!(f, "invalid date time: {error}"),
85            Self::OutOfRange => f.write_str("out of range operation"),
86            Self::NoAvailableLocalTimeType => write!(f, "no local time type is available for the specified timestamp"),
87        }
88    }
89}
90
91impl error::Error for TzError {}
92
93#[cfg(feature = "alloc")]
94impl From<TzFileError> for TzError {
95    fn from(error: TzFileError) -> Self {
96        Self::TzFile(error)
97    }
98}
99
100#[cfg(feature = "alloc")]
101impl From<TzStringError> for TzError {
102    fn from(error: TzStringError) -> Self {
103        Self::TzString(error)
104    }
105}
106
107impl From<LocalTimeTypeError> for TzError {
108    fn from(error: LocalTimeTypeError) -> Self {
109        Self::LocalTimeType(error)
110    }
111}
112
113impl From<TransitionRuleError> for TzError {
114    fn from(error: TransitionRuleError) -> Self {
115        Self::TransitionRule(error)
116    }
117}
118
119impl From<TimeZoneError> for TzError {
120    fn from(error: TimeZoneError) -> Self {
121        Self::TimeZone(error)
122    }
123}
124
125impl From<DateTimeError> for TzError {
126    fn from(error: DateTimeError) -> Self {
127        Self::DateTime(error)
128    }
129}
tz/error/mod.rs

tz/error/
mod.rs
