Struct MockTime 

pub struct MockTime { /* private fields */ }

A complete mock time runtime sharing one timeline across clocks and sleepers.

MockTime is the recommended entry point for tests that need both “what time is it?” and “how long should this operation sleep?” to use the same deterministic time source. It constructs one MockTimeline, then creates a MockClock and MockSleeper over that timeline.

Advancing the runtime through advance advances every component derived from it. This avoids a common testing bug where a mock clock reports one logical time while a mock sleeper or monitor waits on a different logical time source.

Wall-clock anchoring is separate from elapsed mock time. Calling set_time changes the UTC value read at the current timeline instant, but it does not advance or rewind the timeline. Calling reset restores both the elapsed timeline and the clock anchor, and fails if any timeline waiter is active.

Example

use std::time::Duration;

use qubit_clock::{Clock, MockTime};

let mock = MockTime::unix_epoch();
let clock = mock.clock();

assert_eq!(0, clock.millis());

mock.advance(Duration::from_millis(250));

assert_eq!(250, clock.millis());
assert_eq!(Duration::from_millis(250), mock.elapsed());

Implementations

impl MockTime

pub fn at(start: DateTime<Utc>) -> Self

Creates a mock runtime anchored at a UTC time.

Parameters

• start: UTC reading returned before the timeline advances.

Returns

A mock runtime with a clock and sleeper sharing one timeline.

pub fn unix_epoch() -> Self

Creates a mock runtime anchored at the Unix epoch.

Returns

A mock runtime starting at 1970-01-01T00:00:00Z.

pub fn timeline(&self) -> MockTimeline

Returns the shared timeline.

Returns

The timeline that drives all components in this runtime.

pub fn clock(&self) -> MockClock

Returns a clock view over the shared timeline.

Returns

Cloneable mock clock.

pub fn sleeper(&self) -> MockSleeper

Returns a sleeper view over the shared timeline.

Returns

Cloneable mock sleeper.

pub fn elapsed(&self) -> StdDuration

Returns elapsed time on the shared timeline.

Returns

Elapsed mock time.

pub fn advance(&self, duration: StdDuration)

Advances the shared timeline.

Parameters

• duration: Duration to add to mock elapsed time.

pub fn set_time(&self, instant: DateTime<Utc>)

Reanchors the runtime clock at the current timeline instant.

Parameters

• instant: New UTC time returned at the current timeline instant.

pub fn reset(&self) -> Result<(), MockTimeError>

Resets the timeline and clock anchor to the runtime’s initial state.

Returns

Ok(()) when reset succeeds.

Errors

Returns MockTimeError::ActiveWaiters when timeline waiters are active.

Trait Implementations

impl Clone for MockTime

fn clone(&self) -> MockTime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MockTime

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

Formats the value using the given formatter.