runmat-config 0.5.2

Shared configuration schema and loaders for RunMat
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

mod discovery;
mod env;
mod file;

use anyhow::Result;
use log::{debug, info};
use std::path::{Path, PathBuf};

use crate::runtime::RunMatRuntimeConfig;

/// Configuration loader with multiple source support
pub struct ConfigLoader;

impl ConfigLoader {
    /// Load configuration from all sources with proper precedence
    pub fn load() -> Result<RunMatRuntimeConfig> {
        let mut config = Self::load_from_files()?;
        Self::apply_environment_variables(&mut config)?;
        Ok(config)
    }

    /// Find and load configuration from files
    fn load_from_files() -> Result<RunMatRuntimeConfig> {
        if let Ok(config_path) = std::env::var("RUNMAT_CONFIG") {
            let path = PathBuf::from(config_path);
            if path.is_dir() {
                return Err(anyhow::anyhow!(
                    "RUNMAT_CONFIG points to a directory, expected a file: {}",
                    path.display()
                ));
            }
            if !path.is_file() {
                return Err(anyhow::anyhow!(
                    "RUNMAT_CONFIG points to a missing file: {}",
                    path.display()
                ));
            }
            info!(
                "Loading configuration from RUNMAT_CONFIG: {}",
                path.display()
            );
            return Self::load_from_file(&path);
        }

        if let Ok(current_dir) = std::env::current_dir() {
            if let Some(path) = discovery::discover_project_config_path_from(&current_dir) {
                info!("Loading configuration from: {}", path.display());
                return Self::load_from_file(&path);
            }
        }

        if let Some(path) = discovery::user_config_candidates()
            .into_iter()
            .find(|candidate| candidate.is_file())
        {
            info!("Loading configuration from: {}", path.display());
            return Self::load_from_file(&path);
        }

        debug!("No configuration file found, using defaults");
        Ok(RunMatRuntimeConfig::default())
    }

    /// Walk up from the provided directory looking for the first config file.
    pub fn discover_config_path_from(start: &Path) -> Option<PathBuf> {
        discovery::discover_project_config_path_from(start)
    }

    /// Load configuration from a specific file
    pub fn load_from_file(path: &Path) -> Result<RunMatRuntimeConfig> {
        file::load_from_file(path)
    }

    /// Apply environment variable overrides
    fn apply_environment_variables(config: &mut RunMatRuntimeConfig) -> Result<()> {
        env::apply_environment_variables(config)
    }

    /// Save configuration to a file
    pub fn save_to_file(config: &RunMatRuntimeConfig, path: &Path) -> Result<()> {
        file::save_to_file(config, path)
    }

    /// Render runtime config into TOML/JSON text matching the output file contract.
    pub fn render_runtime_config(config: &RunMatRuntimeConfig, path: &Path) -> Result<String> {
        let format = file::format_from_path(path)?;
        file::render_runtime_config(config, format)
    }

    /// Generate a sample configuration file
    pub fn generate_sample_config() -> String {
        file::generate_sample_config()
    }
}