Struct FileWatcherBuilder 

pub struct FileWatcherBuilder {
    config: FileWatcherConfig,
    file_paths: Vec<PathBuf>,
}

A builder for creating file watchers with flexible configuration.

The watcher monitors the parent directory of each file to handle file deletion and recreation properly. Events are filtered to only trigger callbacks for the specific files being watched.

Fields

config: FileWatcherConfig

file_paths: Vec<PathBuf>

Canonicalized paths of files to watch.

Implementations

impl FileWatcherBuilder

pub fn new() -> Self

Create a new builder with default configuration.

pub fn config(self, config: FileWatcherConfig) -> Self

Set the watcher configuration.

pub fn watch_path<P: AsRef<Path>>(self, path: P) -> Result<Self>

Add a file path to watch.

Returns an error if the path is a directory. The path is canonicalized for reliable comparison with events.

pub fn watch_paths<P: AsRef<Path>, I: IntoIterator<Item = P>>( self, paths: I, ) -> Result<Self>

Add multiple file paths to watch.

Returns an error if any path is a directory.

pub fn spawn<F>(self, callback: F) -> Result<()>

where F: Fn() + Send + 'static,

Build and spawn the file watcher with the given callback.

The callback is invoked when relevant file events are detected for the watched files. The watcher monitors the parent directories to handle file deletion and recreation properly.

The spawned watcher thread runs for the lifetime of the process.

Trait Implementations

impl Default for FileWatcherBuilder

fn default() -> Self

Returns the “default value” for a type.