Struct MockSleeper 

pub struct MockSleeper { /* private fields */ }

A manually controlled elapsed-time sleeper for deterministic tests.

This type implements Sleeper by waiting until manually controlled mock elapsed time reaches the requested target. When the tokio feature is enabled, it also implements AsyncSleeper with the same mock elapsed-time semantics.

Testing guidance

Use this type when the code under test sleeps for retry, backoff, polling, or timeout intervals. MockSleeper controls elapsed sleep time only; it does not change the current time returned by crate::MockClock. If a component depends on both current-time reads and sleep completion, inject a MockClock and a MockSleeper separately and advance each one explicitly.

Implementations

impl MockSleeper

pub fn new() -> Self

Creates a mock sleeper whose elapsed time starts at zero.

Returns

A new mock sleeper with zero elapsed time.

pub fn elapsed(&self) -> Duration

Returns the current mock elapsed time.

Returns

The elapsed time observed by this mock sleeper.

pub fn wait_for_blocking_sleepers( &self, count: usize, timeout: Duration, ) -> bool

Waits until at least count synchronous sleeps are blocked.

This method is intended for deterministic tests that need to advance mock time only after another thread has entered Sleeper::sleep_for.

Arguments

• count - The minimum number of blocked synchronous sleepers.
• timeout - The maximum real duration to wait.

Returns

true if the requested number of sleepers is observed before the timeout expires; otherwise false.

pub fn set_elapsed(&self, elapsed: Duration)

Sets the current mock elapsed time.

This wakes all blocking and asynchronous sleepers so they can recheck their target elapsed time.

Arguments

• elapsed - The new elapsed time.

pub fn advance(&self, duration: Duration)

Advances the mock elapsed time by a duration.

Arguments

• duration - The amount to add to the current elapsed time.

pub fn reset(&self)

Resets the mock elapsed time to zero.

Trait Implementations

impl Clone for MockSleeper

fn clone(&self) -> MockSleeper

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MockSleeper

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

Formats the value using the given formatter.

impl Default for MockSleeper

fn default() -> Self

Creates a new mock sleeper.

impl Sleeper for MockSleeper

fn sleep_for(&self, duration: Duration)

Blocks until mock elapsed time has advanced by duration.