Struct Watch 

pub struct Watch {
    pub dirty: Arc<AtomicBool>,
    /* private fields */
}

Spawn a notify watcher rooted at the broker’s state/ directory. Returns None on platforms (or filesystems) where notify can’t bring up a recommended watcher — the run loop then falls back to the 1s poll. The returned Watch keeps the underlying watcher alive; drop it to stop watching.

Fields

dirty: Arc<AtomicBool>

Shared dirty flag — flipped to true on every relevant filesystem event. The run loop reads + clears it via take_dirty.

Implementations

impl Watch

pub fn idle() -> Self

Construct a watch with no underlying watcher. Used by tests and as the fallback when notify::recommended_watcher fails to initialise.

pub fn try_new(state_dir: &Path) -> Self

Try to build a recommended watcher rooted at state_dir. Returns an idle (no-watcher) Watch on any failure so the caller can still rely on the dirty-flag interface even when the platform doesn’t support filesystem notifications.

pub fn take_dirty(&self) -> bool

Read + clear the dirty flag. Returns true exactly once per batch of events the watcher saw since the previous call.