Struct NotifyWatcher 

pub struct NotifyWatcher { /* private fields */ }

Implementations

impl NotifyWatcher

pub const DEBOUNCE: Duration

The built-in debounce window: long enough to coalesce an editor’s save burst or a git checkout, short enough to feel immediate.

pub fn new(roots: &[PathBuf]) -> Result<Self, Error>

Starts watching every root recursively. An error here is fatal to the session before it starts — the CLI turns it into exit code 2.

NoCache rather than the debouncer’s default cache, which on macOS and Windows is a file-ID map: arming a root would walk the whole tree under it and stat every entry, before the watcher — and so before anything the session draws — exists. A project root holding a build directory makes that walk enormous (a Rust target/ reaches hundreds of thousands of files), and the session looks frozen for as long as it runs. The cache buys only rename stitching for back ends that emit no rename cookie, and a batch is read here for its paths alone: a rename reported as two unrelated paths triggers exactly the same rehash as one reported as a pair. Linux already defaults to this for unrelated reasons.

Trait Implementations

impl Watcher for NotifyWatcher

fn next_batch<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Option<WatchBatch>> + Send + 'async_trait>>

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

The next batch; None when the watcher died for good.