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() -> Self

Creates a new loader with default settings.

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

Sets a custom global config path.

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

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>) -> Self

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) -> Self

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) -> Self

Skips environment variable loading.

Useful for testing with deterministic config.

pub fn skip_global_config(self) -> Self

Skips global config loading.

pub fn skip_project_config(self) -> Self

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

Formats the value using the given formatter.

impl Default for ConfigLoader

fn default() -> Self

Returns the “default value” for a type.