Struct ManualClock 

pub struct ManualClock { /* private fields */ }

Manually advanceable clock for deterministic tests.

Starts at UNIX_EPOCH + 1_000_000 s to avoid edge cases near the epoch. All clones share the same underlying time via an std::sync::Arc.

Example

use std::time::Duration;
use fraiseql_core::utils::clock::{Clock, ManualClock};

let clock = ManualClock::new();
let t0 = clock.now_secs();

clock.advance(Duration::from_secs(10));
assert_eq!(clock.now_secs(), t0 + 10);

Implementations

impl ManualClock

pub fn new() -> Self

Create a new clock starting at UNIX_EPOCH + 1_000_000 s.

pub fn advance(&self, delta: Duration)

Advance the clock by delta. All clones see the new time immediately.

Panics

Panics if the internal mutex is poisoned.

pub fn set(&self, t: SystemTime)

Set the clock to an absolute time.

Panics

Panics if the internal mutex is poisoned.

Trait Implementations

impl Clock for ManualClock

Available on crate features test-utils only.

fn now(&self) -> SystemTime

Return the current time.

fn now_secs(&self) -> u64

Return the current Unix timestamp in whole seconds.

fn now_secs_i64(&self) -> i64

Return the current Unix timestamp as a signed 64-bit integer.

impl Clone for ManualClock

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ManualClock

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ManualClock

Available on crate features test-utils only.

fn default() -> Self

Returns the “default value” for a type.