Struct ConfigHandle 

pub struct ConfigHandle<T> { /* private fields */ }

Live, cloneable handle to a loaded config value.

Reads are lock-free via ArcSwap. Writes go through WriteGuard, which atomically updates the in-memory state on drop and optionally persists to the config file (watcher mode only).

Clone the handle freely — all clones share the same live value.

Implementations

impl<T: ConfigSchema> ConfigHandle<T>

pub fn read(&self) -> Guard<Arc<T>>

Lock-free snapshot of the current config. Equivalent to Arc::clone cost.

impl<T: ConfigSchema + Clone + Serialize> ConfigHandle<T>

pub fn write_back( initial: T, path: impl Into<PathBuf>, format: impl Format + Send + Sync + 'static, ) -> Self

Write-back mode: no file watcher, but every WriteGuard drop persists to path.

Use this when you want config.write() to auto-save without spinning up a hot-reload thread.

pub fn write(&self) -> WriteGuard<T>

Return a write guard. On drop the guard:

1. Serializes the modified value and writes it to the config file (watcher mode).
2. Atomically swaps it into the ArcSwap so all readers see the new value.

In manual mode only step 2 happens (no file path is stored).

Trait Implementations

impl<T> Clone for ConfigHandle<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: ConfigSchema> From<T> for ConfigHandle<T>

fn from(config: T) -> Self

Converts to this type from the input type.