Struct FixedClock 

pub struct FixedClock { /* private fields */ }

Test clock with auto-advancing time.

This clock auto-advances on each now_millis() call, providing monotonically increasing timestamps. Use hold() to temporarily freeze the clock for tests needing stable timestamps.

Note: While timestamps are monotonic, concurrent threads may receive values in non-deterministic order depending on scheduling.

Example

use eidetica::{Clock, FixedClock};

let clock = FixedClock::new(1000);
let t1 = clock.now_millis();  // Returns 1000, then advances
let t2 = clock.now_millis();  // Returns next value
assert!(t2 > t1);

// Use hold() for stable timestamps
{
    let _hold = clock.hold();
    let a = clock.now_millis();
    let b = clock.now_millis();
    assert_eq!(a, b);  // Frozen
}

Implementations

impl FixedClock

pub fn new(millis: u64) -> Self

Create a new fixed clock with the given initial time in milliseconds.

pub fn hold(&self) -> ClockHold<'_>

Hold the clock, preventing auto-advance until the guard is dropped.

Returns an RAII guard that releases the hold when dropped. Use a scoped block for clean auto-release:

let clock = FixedClock::new(1000);
let expected = {
    let _hold = clock.hold();
    clock.now_millis()  // Frozen value
};  // hold released

pub fn advance(&self, ms: u64)

Advance the clock by the given number of milliseconds.

pub fn set(&self, ms: u64)

Set the clock to a specific time in milliseconds.

pub fn get(&self) -> u64

Get the current time without advancing (even if not held).

Trait Implementations

impl Clock for FixedClock

Available on crate features testing only.

fn now_millis(&self) -> u64

Returns the current time as milliseconds since Unix epoch.

fn now_rfc3339(&self) -> String

Returns the current time as an RFC3339-formatted string.

fn now_secs(&self) -> i64

Get current time as seconds since Unix epoch.

impl Clone for FixedClock

Available on crate features testing only.

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 FixedClock

Available on crate features testing only.

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

Formats the value using the given formatter.

impl Default for FixedClock

Available on crate features testing only.

fn default() -> Self

Returns the “default value” for a type.