Struct PausedClock 

pub struct PausedClock { /* private fields */ }

Fully-virtual clock for tests.

Stores its own wall-clock cursor and a monotonic counter. Sleeps suspend on an internal Notify and wake when PausedClock::advance or PausedClock::set crosses the deadline. No tokio-runtime cooperation is required: PausedClock works inside current_thread, multi_thread, and start_paused runtimes equally well.

Pairs with tokio::time::pause() for tests that mix this clock with code that uses tokio::time::sleep directly (e.g. tokio::time::timeout).

Implementations

impl PausedClock

pub fn new(origin: OffsetDateTime) -> Arc<Self>

Build a paused clock pinned at origin.

pub fn advance(&self, duration: Duration)

Advance wall + monotonic by duration and wake any sleepers whose deadlines are now in the past.

pub fn advance_time(&self, duration: Duration)

Advance using a time::Duration. Negative durations are clamped to zero.

pub fn advance_ticks(&self, ticks: u32, tick: Duration)

Step ticks times by tick, notifying sleepers between every step so tasks observing intermediate wake-ups see each notification.

pub fn set(&self, wall: OffsetDateTime)

Pin the wall clock to wall. Monotonic counter advances by the (signed) delta, never moving backwards.

Trait Implementations

impl Clock for PausedClock

fn now_utc(&self) -> OffsetDateTime

Current wall-clock UTC time.

fn monotonic_ms(&self) -> i64

Monotonic milliseconds since an implementation-defined origin.

fn sleep<'life0, 'async_trait>( &'life0 self, duration: Duration, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Sleep for duration. No-op when duration is zero.

fn sleep_until_utc<'life0, 'async_trait>( &'life0 self, deadline: OffsetDateTime, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Sleep until the wall-clock UTC deadline. No-op if deadline is in the past.

impl Debug for PausedClock

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

Formats the value using the given formatter.