Struct FileWatcher 

pub struct FileWatcher { /* private fields */ }

File system watcher that detects changes in a project directory.

Implementations

impl FileWatcher

pub fn new(root: &Path, config: &WatchConfig) -> Result<Self>

Create a new file watcher for the given directory.

Uses native OS filesystem events by default (inotify on Linux, kqueue on macOS, ReadDirectoryChanges on Windows). Falls back to polling when config.poll_ms is set — useful for network filesystems that don’t support native events.

pub fn wait_for_changes(&mut self) -> Vec<PathBuf>

Wait for file changes and return the changed paths (debounced). This blocks until changes are detected.

pub fn poll_changes(&mut self, timeout: Duration) -> Vec<PathBuf>

Non-blocking poll for file changes with a timeout.

Returns changed paths (debounced) or an empty vec if no changes occurred within the timeout. Does NOT block indefinitely.

pub fn root(&self) -> &Path

Get the root directory being watched.