rite-runtime 0.7.1

Execution engine for Rite ceremonies (internal to the `rite` CLI; no stable API)
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

//! The ceremony clock: the single source of wall-clock time for the run.
//!
//! Event time is part of the hashed transcript line, so it is audit evidence.
//! It is owned by the executor (the authority on what happened), not by the
//! transcript sink (a swappable persistence detail): the same `at` the sink
//! writes is the `at` the live frontend sees, and it does not change if the
//! storage backend changes. Reading the clock is the one nondeterministic input
//! in the record path, so it lives behind this trait and can be faked in tests.

use chrono::{DateTime, Utc};

/// Source of wall-clock time for a ceremony run.
///
/// Implementations must be cheap to call (read once per emitted fact) and
/// thread-safe: the executor runs on its own thread and shares the clock with
/// the [`Reporter`](crate::Reporter).
pub trait Clock: Send + Sync {
    /// The current instant, in UTC.
    fn now(&self) -> DateTime<Utc>;
}

/// The real clock: reads the host wall clock via [`Utc::now`]. The default for
/// every production run.
#[derive(Debug, Clone, Copy, Default)]
pub struct SystemClock;

impl Clock for SystemClock {
    fn now(&self) -> DateTime<Utc> {
        Utc::now()
    }
}