Struct ConfigResolver 

pub struct ConfigResolver { /* private fields */ }

Resolves layered config input into the runtime view seen by the rest of the application.

Callers usually populate the individual source layers first and then ask the resolver for either the final runtime view or an explanation trace.

High-level flow:

• select one winning raw value per key using source and scope precedence
• interpolate placeholders inside the selected winners
• adapt and validate the interpolated values against the schema
• optionally expose an explanation trace that shows why each winner won

Contract:

• precedence rules live here, not in callers
• schema adaptation happens after winner selection, not while scanning layers
• bootstrap handling stays aligned with the config bootstrap helpers rather than becoming a separate merge system

Implementations

impl ConfigResolver

pub fn from_loaded_layers(layers: LoadedLayers) -> Self

Creates a resolver from pre-loaded config layers.

pub fn from_loaded_layers_with_schema( layers: LoadedLayers, schema: ConfigSchema, ) -> Self

Creates a resolver from pre-loaded config layers and an explicit schema.

pub fn set_schema(&mut self, schema: ConfigSchema)

Replaces the schema used for validation and adaptation.

pub fn schema_mut(&mut self) -> &mut ConfigSchema

Returns mutable access to the active schema.

pub fn defaults_mut(&mut self) -> &mut ConfigLayer

Returns mutable access to the built-in defaults layer.

pub fn file_mut(&mut self) -> &mut ConfigLayer

Returns mutable access to the config file layer.

pub fn presentation_mut(&mut self) -> &mut ConfigLayer

Returns mutable access to the presentation defaults layer.

pub fn secrets_mut(&mut self) -> &mut ConfigLayer

Returns mutable access to the secrets layer.

pub fn env_mut(&mut self) -> &mut ConfigLayer

Returns mutable access to the environment layer.

pub fn cli_mut(&mut self) -> &mut ConfigLayer

Returns mutable access to the CLI layer.

pub fn session_mut(&mut self) -> &mut ConfigLayer

Returns mutable access to the session layer.

pub fn set_defaults(&mut self, layer: ConfigLayer)

Replaces the built-in defaults layer.

pub fn set_file(&mut self, layer: ConfigLayer)

Replaces the config file layer.

pub fn set_presentation(&mut self, layer: ConfigLayer)

Replaces the presentation defaults layer.

pub fn set_secrets(&mut self, layer: ConfigLayer)

Replaces the secrets layer.

pub fn set_env(&mut self, layer: ConfigLayer)

Replaces the environment layer.

pub fn set_cli(&mut self, layer: ConfigLayer)

Replaces the CLI layer.

pub fn set_session(&mut self, layer: ConfigLayer)

Replaces the session layer.

pub fn resolve( &self, options: ResolveOptions, ) -> Result<ResolvedConfig, ConfigError>

Resolves all configured layers into the final runtime config.

Source precedence still applies inside this API, so later layers like session or CLI overrides can replace lower-priority defaults.

Examples

use osp_cli::config::{ConfigResolver, LoadedLayers, ResolveOptions};

let mut layers = LoadedLayers::default();
layers.defaults.set("profile.default", "default");
layers.defaults.set("theme.name", "plain");
layers.session.set("theme.name", "dracula");

let resolved = ConfigResolver::from_loaded_layers(layers)
    .resolve(ResolveOptions::default())
    .unwrap();

assert_eq!(resolved.get_string("theme.name"), Some("dracula"));

pub fn explain_key( &self, key: &str, options: ResolveOptions, ) -> Result<ConfigExplain, ConfigError>

Explains how a runtime key was selected, interpolated, and adapted.

The explanation keeps the raw winning value as well as the final adapted value so callers can see where interpolation or type coercion changed the original input.

Examples

use osp_cli::config::{ConfigResolver, LoadedLayers, ResolveOptions};

let mut layers = LoadedLayers::default();
layers.defaults.set("profile.default", "default");
layers.defaults.set("theme.name", "plain");
layers.cli.set("theme.name", "dracula");

let explain = ConfigResolver::from_loaded_layers(layers)
    .explain_key("theme.name", ResolveOptions::default())
    .unwrap();

assert_eq!(explain.key, "theme.name");
assert_eq!(
    explain.final_entry.unwrap().value.reveal(),
    &osp_cli::config::ConfigValue::String("dracula".to_string())
);

pub fn explain_bootstrap_key( &self, key: &str, options: ResolveOptions, ) -> Result<BootstrapConfigExplain, ConfigError>

Explains bootstrap resolution for a bootstrap-only key.

Trait Implementations

impl Clone for ConfigResolver

fn clone(&self) -> ConfigResolver

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfigResolver

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

Formats the value using the given formatter.

impl Default for ConfigResolver

fn default() -> ConfigResolver

Returns the “default value” for a type.