Function load

crates/openshell-server/src/config_file.rs:195–223

Load and validate a TOML config file. Returns `Ok(ConfigFile::default())` for an empty file (the gateway then falls back entirely to CLI/env/built-in defaults).

(path: &Path)

/// Returns `Ok(ConfigFile::default())` for an empty file (the gateway then
/// falls back entirely to CLI/env/built-in defaults).
pub fn load(path: &Path) -> Result<ConfigFile, ConfigFileError> {
    let contents = std::fs::read_to_string(path).map_err(|source| ConfigFileError::Io {
        path: path.to_path_buf(),
        source,
    })?;
    if contents.trim().is_empty() {
        return Ok(ConfigFile::default());
    }
    let file: ConfigFile = toml::from_str(&contents).map_err(|source| ConfigFileError::Parse {
        path: path.to_path_buf(),
        source,
    })?;

    if let Some(version) = file.openshell.version
        && version > SCHEMA_VERSION
    {
        return Err(ConfigFileError::UnsupportedVersion { version });
    }

    if file.openshell.gateway.database_url.is_some() {
        return Err(ConfigFileError::SecretInFile {
            field: "database_url",
            env: "OPENSHELL_DB_URL",
            cli: "--db-url",
        });
    }

    Ok(file)
}

/// Build the merged TOML table for `driver` by overlaying inheritable
/// `[openshell.gateway]` defaults onto `[openshell.drivers.<name>]`.