timeflake 0.1.0

Rust port of Timeflake, a 128-bit, roughly-ordered, URL-safe UUID
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

use core::fmt;

#[derive(Debug)]
#[non_exhaustive]
pub enum Error {
    /// The provided bytes resulted in an invalid Timeflake value.
    ///
    /// This happens when the integer value is out of the valid range.
    InvalidFlake,

    /// Failed to parse the provided string into a Timeflake.
    ParseError {
        /// The string that failed to parse.
        input: String,
        /// The detailed reason for the parse failure.
        reason: String,
    },

    /// The timestamp component is invalid (exceeds MAX_TIMESTAMP).
    InvalidTimestamp(u64),

    /// The random component is invalid (exceeds MAX_RANDOM).
    InvalidRandom,

    /// An error occurred during conversion to or from UUID.
    UuidError(String),

    /// General conversion error.
    ConversionError(String),
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Error::InvalidFlake => write!(f, "Invalid Timeflake: value out of valid range"),
            Error::ParseError { input, reason } => {
                write!(f, "Failed to parse '{}' as Timeflake: {}", input, reason)
            }
            Error::InvalidTimestamp(ts) => {
                write!(f, "Invalid timestamp: {} exceeds maximum allowed value", ts)
            }
            Error::InvalidRandom => {
                write!(f, "Invalid random component: exceeds maximum allowed value")
            }
            Error::UuidError(msg) => write!(f, "UUID error: {}", msg),
            Error::ConversionError(msg) => write!(f, "Conversion error: {}", msg),
        }
    }
}

pub type Result<T> = core::result::Result<T, Error>;