Struct ConfigLoader 

pub struct ConfigLoader { /* private fields */ }

Loads typed configuration from ordered source adapters.

ConfigLoader::app() / ConfigLoader::new() keeps the service-oriented policy: defaults → TOML → profile dotenv → dotenv → adapter sources → env → overrides. ConfigLoader::toml(path) is deterministic file-only loading. ConfigLoader::custom() only loads explicitly provided sources.

Implementations

impl ConfigLoader

pub fn new() -> ConfigLoader

Create an application/service loader.

pub fn app() -> ConfigLoader

Create an application/service loader.

pub fn toml(path: impl Into<PathBuf>) -> ConfigLoader

Create a deterministic single-TOML loader.

This policy does not read dotenv files or process environment variables.

pub fn custom() -> ConfigLoader

Create a loader with no implicit sources.

pub fn with_default( self, key: impl Into<String>, value: impl Into<Value>, ) -> ConfigLoader

Set a programmatic default value.

Defaults are loaded before all configured sources.

pub fn with_config_file(self, path: impl Into<PathBuf>) -> ConfigLoader

Explicitly set the TOML config file path for app loading.

pub fn with_env_file(self, path: impl Into<PathBuf>) -> ConfigLoader

Explicitly set the .env file path for app loading.

pub fn with_env_prefix(self, prefix: impl Into<String>) -> ConfigLoader

Override the env-var prefix for app loading.

Separator is always "__".

pub fn with_profile(self, profile: impl Into<String>) -> ConfigLoader

Set the configuration profile for app loading.

Loads config/profiles/{profile}.env before the main .env file. If an empty string is passed, the profile name is read from the ENVIRONMENT environment variable during loading.

pub fn with_source(self, source: impl ConfigSource) -> ConfigLoader

Add an adapter source.

In app loading, adapter sources are evaluated after files/dotenv and before process environment variables. In custom/TOML loading, adapter sources are evaluated after the primary file and before overrides.

pub fn with_override( self, key: impl Into<String>, value: impl Into<Value>, ) -> ConfigLoader

Set a programmatic override value.

Overrides are loaded after all sources and have the highest precedence.

pub fn load<T>(&self) -> Result<T, AppError>

where T: DeserializeOwned,

Load any typed config from this loader’s source policy.

This path does not run validation; the type only needs to be Deserialize. Use ConfigLoader::load_validated to additionally run rskit_validation::Validate, or ConfigLoader::load_app for the service-application convenience.

pub fn load_with<T>( &self, apply_defaults: impl FnOnce(&mut T), ) -> Result<T, AppError>

where T: DeserializeOwned,

Load any typed config and apply programmatic defaults (no validation).

pub fn load_validated<T>(&self) -> Result<T, AppError>

where T: DeserializeOwned + Validate,

Load a typed config and run rskit_validation::Validate after decoding.

pub fn load_validated_with<T>( &self, apply_defaults: impl FnOnce(&mut T), ) -> Result<T, AppError>

where T: DeserializeOwned + Validate,

Load a typed config, apply programmatic defaults, then run validation.

pub fn load_app<T>(&self) -> Result<T, AppError>

where T: AppConfig,

Load an application/service config and call AppConfig::apply_defaults.

Applies defaults via AppConfig::apply_defaults, then runs validation.

Trait Implementations

impl Debug for ConfigLoader

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for ConfigLoader

fn default() -> ConfigLoader

Returns the “default value” for a type.