Struct ConfigLoader 

pub struct ConfigLoader<S: ConfigSchema> { /* private fields */ }

Builds and executes a layered configuration load.

Sources are merged in registration order (first = lowest priority). Because sources are stored as Arc, the loader is cheaply cloneable and its sources can be captured in hot-reload closures without duplicating state.

Implementations

impl<S: ConfigSchema> ConfigLoader<S>

pub fn with_source(self, source: impl Source + Send + Sync + 'static) -> Self

Add a passive source (env vars, CLI args, etc.).

Passive sources are collected once at load time. In selective hot-reload mode (watch_auto) their initial cache is reused for every re-merge; they never trigger a reload themselves. Use with_watched_source for file-backed or redb sources that should trigger selective reloads.

pub fn with_migrations(self, migrations: MigrationChain) -> Self

pub fn with_encryptor(self, encryptor: impl Encryptor + 'static) -> Self

pub fn load(&self) -> Result<S, LoadError>

Merge all sources, run migrations if needed, decrypt fields, and deserialize.

Errors

Returns LoadError on source, migration, crypto, or deserialization failure.

Trait Implementations

impl<S: ConfigSchema> Clone for ConfigLoader<S>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: ConfigSchema> Default for ConfigLoader<S>

fn default() -> Self

Returns the “default value” for a type.