appcore-log 1.0.0-rc.1

Structured, bounded, security-first operational logging for AppCore
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

// =============================================================================
//        #######
//     ###       ###     F: clock.rs
//    ##   ## ##   ##    P: AppCore-Runtime
//         ## ##
//                       C: working-tree by dnettoRaw
//    ##   ## ##   ##    U: working-tree by dnettoRaw
//      ###########      S: 1.0.2-rc
// =============================================================================

//! Explicit clocks keep event timestamps deterministic at test boundaries.

/// Supplies Unix timestamps in milliseconds at an application boundary.
pub trait LogClock: Send + Sync {
    /// Returns the current Unix timestamp in milliseconds.
    fn now_ms(&self) -> u64;
}

/// Production wall-clock implementation with a controlled pre-epoch fallback.
#[derive(Debug, Default, Clone, Copy)]
pub struct SystemLogClock;

impl LogClock for SystemLogClock {
    fn now_ms(&self) -> u64 {
        std::time::SystemTime::now()
            .duration_since(std::time::UNIX_EPOCH)
            .map(|duration| duration.as_millis().try_into().unwrap_or(u64::MAX))
            .unwrap_or_default()
    }
}

/// Deterministic clock for tests and reproducible examples.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct FixedLogClock(u64);

impl FixedLogClock {
    /// Creates a clock returning exactly `timestamp_ms`.
    pub const fn new(timestamp_ms: u64) -> Self {
        Self(timestamp_ms)
    }
}

impl LogClock for FixedLogClock {
    fn now_ms(&self) -> u64 {
        self.0
    }
}