Struct KernelConfigWatcher 

pub struct KernelConfigWatcher { /* private fields */ }

A poll-based config file watcher that detects changes and applies them without requiring a restart.

It polls the file’s mtime every 5 seconds, re-reads and validates on change, and notifies registered callbacks with the new config and a diff summary.

Implementations

impl KernelConfigWatcher

pub fn new(config_path: PathBuf, initial_config: PunchConfig) -> Self

Create a new watcher for the given config file path with an initial config.

pub async fn on_change<F>(&self, callback: F)

where F: Fn(&PunchConfig, &KernelConfigDiff) + Send + Sync + 'static,

Register a callback that will be invoked when the config changes.

Multiple callbacks can be registered. They are called in registration order with a reference to the new config and the diff summary.

pub async fn current_config(&self) -> PunchConfig

Get a clone of the current config.

pub fn config_arc(&self) -> Arc<RwLock<PunchConfig>>

Get a shared reference to the underlying config Arc.

pub fn watch(&self) -> JoinHandle<()>

Start the poll loop. Returns a JoinHandle for the spawned task.

The task checks the config file’s mtime every 5 seconds. On change:

1. Reads and parses the file as TOML
2. Validates the new config (keeps old config on error)
3. Computes the diff and logs changes
4. Warns about non-reloadable changes
5. Swaps the config under the RwLock
6. Notifies all registered callbacks