M1.2: native file watching via notify
- notify 8.2.0 (CC0-1.0) behind the existing Watcher API, allowed by a crate-scoped [[licenses.exceptions]] entry in deny.toml (owner decision 2026-10-14, noted in AGENTS.md and NOTICE). - Native notifications only mark directories dirty; after 100 ms of quiet (at most 10 intervals) dirty dirs are rescanned and diffed, so events, debouncing and rename pairing match the polling backend. - Polling stays as fallback when the native watcher cannot start, and per directory when a native watch is refused. Lost events or watcher errors trigger a full rescan; root loss is checked on every tick. - Additive API: WatchOptions::backend (Auto, Polling) and Watcher::is_native. - Watch tests run on both backends (34 vfs tests on Windows). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
parent
5d49b57b9c
commit
3f190a635e
11 changed files with 500 additions and 86 deletions
|
|
@ -33,7 +33,8 @@
|
|||
//!
|
||||
//! # Watching
|
||||
//! [`Project::watch`] returns a [`Watcher`] and a channel of [`VfsEvent`]s;
|
||||
//! see the `watch` module for the polling design and its limits.
|
||||
//! see the `watch` module for the native backend (`notify`), its polling
|
||||
//! fallback and their limits.
|
||||
//!
|
||||
//! # File IO
|
||||
//! [`read_text`] reads up to [`DEFAULT_READ_LIMIT`] bytes and decodes UTF-8
|
||||
|
|
@ -54,4 +55,4 @@ pub use io::{
|
|||
};
|
||||
pub use project::{Entry, EntryKind, Listing, MAX_CHILDREN, PathStatus, Project, ProjectOptions};
|
||||
pub use rules::{EntryRole, GlobalExcludes};
|
||||
pub use watch::{VfsEvent, WatchOptions, Watcher};
|
||||
pub use watch::{VfsEvent, WatchBackend, WatchOptions, Watcher};
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue