humfmt 0.6.0

Ergonomic human-readable formatting toolkit for Rust
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

use core::fmt;

/// Error returned when a duration-like value is negative.
///
/// This is primarily used by optional ecosystem adapters (`chrono` / `time`)
/// when converting into `core::time::Duration` (which is always non-negative).
#[derive(Copy, Clone, Debug, Eq, PartialEq)]
pub struct NegativeDurationError;

/// Conversion error for duration adapters.
///
/// This error provides more explicit semantics than [`NegativeDurationError`]
/// by distinguishing between:
///
/// - negative inputs
/// - values that cannot be represented as `core::time::Duration`
#[derive(Copy, Clone, Debug, Eq, PartialEq)]
pub enum DurationConversionError {
    /// The provided duration is negative.
    NegativeDuration,
    /// The provided duration is out of the supported range.
    OutOfRange,
}

impl fmt::Display for NegativeDurationError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str("negative durations are not supported by this formatter")
    }
}

impl fmt::Display for DurationConversionError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Self::NegativeDuration => {
                f.write_str("negative durations are not supported by this formatter")
            }
            Self::OutOfRange => f.write_str("duration value is out of supported range"),
        }
    }
}

impl From<NegativeDurationError> for DurationConversionError {
    fn from(_: NegativeDurationError) -> Self {
        Self::NegativeDuration
    }
}

#[cfg(feature = "std")]
impl std::error::Error for NegativeDurationError {}

#[cfg(feature = "std")]
impl std::error::Error for DurationConversionError {}