Struct ConfigWatcher 

pub struct ConfigWatcher { /* private fields */ }

Watches the config file for changes and sends reload events.

Implementations

impl ConfigWatcher

pub fn new( config_path: &Path, debounce_delay_ms: u64, ) -> Result<ConfigWatcher, Error>

Create a new config watcher.

Attempts to use the platform’s native watcher (RecommendedWatcher: inotify on Linux, kqueue on macOS, ReadDirectoryChanges on Windows) for low-latency, event-driven notifications. If the native backend fails to initialise (e.g. inside a container or on a network filesystem), falls back to a PollWatcher that checks for changes every 500 ms.

Arguments

• config_path - Path to the config file to watch.
• debounce_delay_ms - Debounce delay in milliseconds to avoid rapid reloads.

Errors

Returns an error if the config file doesn’t exist or watching fails on both backends.

pub fn try_recv(&self) -> Option<ConfigReloadEvent>

Check for pending config reload events (non-blocking).

Returns the next reload event if one is available, or None if no events are pending.

Trait Implementations

impl Debug for ConfigWatcher

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

Formats the value using the given formatter.