Struct ConfigLoader 

pub struct ConfigLoader { /* private fields */ }

Configuration loader with builder pattern.

Example

use orcs_runtime::config::ConfigLoader;

let config = ConfigLoader::new()
    .with_project_root("/path/to/project")
    .skip_env_vars()  // For testing
    .load()?;

Implementations

impl ConfigLoader

pub fn new() -> ConfigLoader

Creates a new loader with default settings.

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

Sets a custom global config path.

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

Sets the project root directory.

Project config will be loaded from <project_root>/.orcs/config.toml.

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

Sets the profile to activate.

The profile’s [config] section is merged as a layer between project config and env vars. The profile is loaded from ProfileStore search dirs.

pub fn with_env_overrides(self, overrides: EnvOverrides) -> ConfigLoader

Injects pre-built environment overrides.

When set, load() uses these instead of reading std::env::var. This enables deterministic testing without env mutation.

Ignored if skip_env_vars() is also called.

pub fn skip_env_vars(self) -> ConfigLoader

Skips environment variable loading.

Useful for testing with deterministic config.

pub fn skip_global_config(self) -> ConfigLoader

Skips global config loading.

pub fn skip_project_config(self) -> ConfigLoader

Skips project config loading.

pub fn load(&self) -> Result<OrcsConfig, ConfigError>

Loads and merges configuration from all sources.

Errors

Returns ConfigError if any config file exists but cannot be parsed. Missing config files are silently ignored.

Trait Implementations

impl Clone for ConfigLoader

fn clone(&self) -> ConfigLoader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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.