Struct FakeClock 

pub struct FakeClock { /* private fields */ }

Fake clock for deterministic unit and scenario testing.

Inject with crate::Database::open_with_clock. On a fresh database the stamps are exactly what the caller sets, which is the point: a bitemporal test that has to accommodate wall-clock recorded_at values cannot assert on them, so most of the interesting divergence properties were previously written against valid_time alone or against a hand-driven connection.

On a database that already holds rows, open_with_clock raises this clock to their newest recorded_at before the actor starts — see Clock::raise_floor. That is not optional and it does cost determinism: reopening a populated database with a fake starting at the epoch would otherwise abort the first concept write on trg_concepts_monotonic_ra. Tests wanting exact stamps should start from an empty file.

Implementations

impl FakeClock

pub fn new(initial: SystemTime) -> Self

pub fn advance(&self, duration: Duration)

pub fn peek(&self) -> String

The stamp this clock would issue next, without issuing it.

Trait Implementations

impl Clock for FakeClock

fn now(&self) -> String

Returns the current timestamp as ISO-8601 UTC string (e.g. “YYYY-MM-DDTHH:MM:SS.ffffffZ”).

fn raise_floor(&self, floor: SystemTime)

Raise this clock’s floor to floor, if it is currently behind it.