Struct MockClock 

pub struct MockClock { /* private fields */ }

Deterministic test clock (REQ-CLK-005).

• Advances only by explicit calls — the OS is never consulted (G3).
• mono is additive-only and can never go backward.
• wall is a separate signed field; step_wall moves it without touching mono, simulating NTP slews and PTP steps.
• Shared-handle use is safe: cells are atomic (or critical-section) backed, and single-threaded use — the spec’s determinism contract — is exactly reproducible.

The process-wide monotonic floor is deliberately not applied here (see crate::monotonic): ambient real-clock reads elsewhere in a test binary must not perturb a fiction.

Example

use clock_kit::{Clock, ClockSource, MockClock};
use std::time::Duration;

let clock = MockClock::start_at(10, 1_000_000);
assert_eq!(clock.now().mono, 10);
clock.advance(Duration::from_nanos(90));
assert_eq!(clock.now().mono, 100);
clock.step_wall(-500_000); // wall steps, mono does not
assert_eq!(clock.now().mono, 100);
assert_eq!(clock.source(), ClockSource::Mock);

Implementations

impl MockClock

pub fn start_at(mono_ns: u64, wall_ns: u64) -> Self

A mock starting at mono_ns / wall_ns (both nanos; wall is signed-epoch, mono is process-local scale).

pub fn new() -> Self

A mock starting everything at zero.

pub fn advance(&self, dt: Duration)

Advance mono (and mono only) by dt. Deterministic.

pub fn advance_nanos(&self, ns: u64)

Advance mono by ns nanoseconds. Deterministic.

pub fn step_wall(&self, offset_ns: i64)

Step the wall field by offset_ns (negative = backward, e.g. an NTP correction) without touching mono. REQ-CLK-005 skew tests.

pub fn wall_nanos(&self) -> u64

Current wall reading, epoch nanos.

pub fn mono_nanos(&self) -> u64

Current monotonic reading, nanos.

Trait Implementations

impl Clock for MockClock

fn now(&self) -> Timestamp

Current reading. t.mono never decreases across calls within a process, even if the underlying source regresses. REQ-CLK-001.

fn quality(&self) -> SyncQuality

Advisory sync quality of the underlying source (G2 — a hint, never a guarantee). REQ-CLK-004.

fn source(&self) -> ClockSource

Which underlying source reads are actually served from. REQ-CLK-003.

impl Debug for MockClock

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

Formats the value using the given formatter.

impl Default for MockClock

fn default() -> Self

Returns the “default value” for a type.