Struct HolderNotice 

pub struct HolderNotice<Sink: Write> { /* private fields */ }

What: A wait notice that prints a line to a sink once the wait is slow, and again at every interval. Why: Brief contention stays silent, as the incumbent’s waits were; a long wait stops looking like a hang, and a wait that is still going keeps saying so.

In TS you’d write (pseudocode):

const onSlow = (waitedMs) => sink.write(slowWaitLine(...))

Implementations

impl<Sink: Write> HolderNotice<Sink>

pub fn new( lock_directory: &Path, subject: &'static str, limit: Duration, sink: Sink, ) -> Self

A notice for one lock, subject and limit.

Trait Implementations

impl<Sink: Write> WaitNotice for HolderNotice<Sink>

fn waiting(&mut self)

The first busy attempt says nothing: most waits end within the grace.

fn slow(&mut self, waited: Duration)

Print the wait line naming the holder when its record can be read; the wait calls this after the grace and at every interval.

fn announces_at_start(&self) -> bool

Whether waiting already said so out loud, so the first slow call comes one interval after the start instead of after the grace.