Struct Coalescer 

pub struct Coalescer { /* private fields */ }

The coalescing machine. See the module doc for the laws it encodes.

Implementations

impl Coalescer

pub fn new(quiet: Duration) -> Self

A machine with the given semantic quiet window (the named CLI parameter; 100 ms is the declared, visible default at the CLI).

pub fn relevant_event(&mut self, now: Instant) -> Directive

One relevant filesystem event at now: opens a burst or resets THE deadline of the open one; during a build it marks the newer generation dirty.

pub fn quiet_deadline_elapsed(&mut self, now: Instant) -> Directive

THE quiet deadline fired at now. A stale firing (the deadline was re-armed after this firing was scheduled) is recognized by time and ignored; a ripe firing starts the build the burst already made dirty — expiry never discovers work, it starts known work.

pub fn build_completed( &mut self, completed: BuildGeneration, now: Instant, ) -> [Directive; 2]

The in-flight build for generation completed (successfully or not — candidate handling is the caller’s; this machine only decides staleness and follow-up scheduling).

pub fn watcher_desynchronized(&mut self, now: Instant) -> Directive

The watcher reported loss (overflow/desynchronization): the backend no longer promises completeness, so the caller takes ONE full content snapshot and rebuilds it — immediately, not debounced; the loss already coalesced everything it swallowed. During a build the snapshot rebuild becomes the (ripe) follow-up.

Trait Implementations

impl Debug for Coalescer

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

Formats the value using the given formatter.