Struct ConfigResolver 

pub struct ConfigResolver {
    pub cli_flags: HashMap<String, Option<String>>,
    pub config_file: Option<HashMap<String, String>>,
    pub defaults: HashMap<&'static str, &'static str>,
    /* private fields */
}

Resolved configuration following 4-tier precedence:

1. CLI flags — highest priority
2. Environment variables
3. Config file (YAML, dot-flattened keys)
4. Built-in defaults — lowest priority

Fields

cli_flags: HashMap<String, Option<String>>

CLI flags map (flag name → value or None if not provided).

config_file: Option<HashMap<String, String>>

Flattened key → value map loaded from the config file. None if the file was not found or could not be parsed.

defaults: HashMap<&'static str, &'static str>

Built-in default values.

Implementations

impl ConfigResolver

pub const DEFAULTS: &'static [(&'static str, &'static str)]

Default configuration values.

pub fn new( cli_flags: Option<HashMap<String, Option<String>>>, config_path: Option<PathBuf>, ) -> Self

Create a new ConfigResolver.

Arguments

• cli_flags — CLI flag overrides (e.g. --extensions-dir → /path)
• config_path — Optional explicit path to apcore.yaml

pub fn resolve( &self, key: &str, cli_flag: Option<&str>, env_var: Option<&str>, ) -> Option<String>

Resolve a configuration value using 4-tier precedence.

Arguments

• key — dot-separated config key (e.g. "extensions.root")
• cli_flag — optional CLI flag name to check in _cli_flags
• env_var — optional environment variable name

Returns None when the key is not present in any tier.

pub fn flatten_dict(&self, map: Value) -> HashMap<String, String>

Recursively flatten a nested JSON map into dot-separated keys.

Example: {"extensions": {"root": "/path"}} → {"extensions.root": "/path"}