Struct Config

pub struct Config { /* private fields */ }

Watcher Backend configuration

This contains multiple settings that may relate to only one specific backend, such as to correctly configure each backend regardless of what is selected during runtime.

let config = Config::default()
    .with_poll_interval(Duration::from_secs(2))
    .with_compare_contents(true);

Some options can be changed during runtime, others have to be set when creating the watcher backend.

Implementations

impl Config

pub fn with_poll_interval(self, dur: Duration) -> Config

For the PollWatcher backend.

Interval between each re-scan attempt. This can be extremely expensive for large file trees so it is recommended to measure and tune accordingly.

The default poll frequency is 30 seconds.

This will enable automatic polling, overwriting with_manual_polling().

pub fn poll_interval(&self) -> Option<Duration>

Returns current setting

pub fn with_manual_polling(self) -> Config

For the PollWatcher backend.

Disable automatic polling. Requires calling crate::PollWatcher::poll() manually.

This will disable automatic polling, overwriting with_poll_interval().

pub fn with_compare_contents(self, compare_contents: bool) -> Config

For the PollWatcher backend.

Optional feature that will evaluate the contents of changed files to determine if they have indeed changed using a fast hashing algorithm. This is especially important for pseudo filesystems like those on Linux under /sys and /proc which are not obligated to respect any other filesystem norms such as modification timestamps, file sizes, etc. By enabling this feature, performance will be significantly impacted as all files will need to be read and hashed at each poll_interval.

This can’t be changed during runtime. Off by default.

pub fn compare_contents(&self) -> bool

Returns current setting

pub fn with_follow_symlinks(self, follow_symlinks: bool) -> Config

For the INotifyWatcher, KqueueWatcher, and PollWatcher.

Determine if sybolic links should be followed when recursively watching a directory.

This can’t be changed during runtime. On by default.

pub fn follow_symlinks(&self) -> bool

Returns current setting

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl Hash for Config

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Config

fn eq(&self, other: &Config) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Config

impl Eq for Config

impl StructuralPartialEq for Config