Struct HotConfig 

pub struct HotConfig { /* private fields */ }

Hot-reloadable configuration object.

Internally holds an Arc<RwLock<ConfigSnapshot>> and a [watch::Sender<u64>] channel. Call start_watcher to spawn a background Tokio task that polls the file for mtime changes.

Implementations

impl HotConfig

pub fn new(path: &str, poll_interval: Duration) -> Self

Create a HotConfig backed by a file path.

The file is loaded immediately. If loading fails the config starts with an empty snapshot (version 0).

pub fn from_defaults() -> Self

Create an in-memory HotConfig with no backing file.

Useful for tests and programmatic configuration.

pub fn set(&self, key: &str, value: ConfigValue)

Programmatically set a key/value in the current snapshot.

Increments the version counter and notifies all subscribers.

pub fn get(&self, key: &str) -> Option<ConfigValue>

Read the value for key from the current snapshot.

pub fn get_or_default<T: FromConfigValue>(&self, key: &str, default: T) -> T

Read key, coerce it to T, or return default on miss/type error.

pub fn subscribe(&self) -> Receiver<u64>

Subscribe to version-change notifications.

The receiver yields the new version number each time the config is reloaded (or set is called).

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

Spawn a background Tokio task that polls the backing file for changes.

Returns a [tokio::task::JoinHandle] that the caller can abort or await. If no file path was configured (e.g. created via from_defaults), the spawned task exits immediately.