Struct ConfigLoader 

pub struct ConfigLoader { /* private fields */ }

Configuration loader and parser

Implementations

impl ConfigLoader

pub fn new<P>(path: P) -> Result<ConfigLoader, ConfigError>

where P: AsRef<Path>,

Create a new config loader from a file path

Arguments

• path - Path to the ggen.toml file

Errors

Returns an error if the file doesn’t exist or path validation fails

pub fn from_file<P>(path: P) -> Result<GgenConfig, ConfigError>

where P: AsRef<Path>,

Load and parse configuration from a file

Arguments

• path - Path to the ggen.toml file

Errors

Returns an error if the file cannot be read or parsed

Example

use ggen_config::config_lib::ConfigLoader;

let config = ConfigLoader::from_file("ggen.toml")?;
println!("Loaded project: {}", config.project.name);

pub fn from_str(content: &str) -> Result<GgenConfig, ConfigError>

Load and parse configuration from a string

Arguments

• content - TOML content as a string

Errors

Returns an error if the TOML cannot be parsed

Example

use ggen_config::config_lib::ConfigLoader;

let toml = r#"
    [project]
    name = "my-project"
    version = "1.0.0"
"#;

let config = ConfigLoader::from_str(toml)?;
assert_eq!(config.project.name, "my-project");

pub fn load(&self) -> Result<GgenConfig, ConfigError>

Load configuration from the stored file path

Errors

Returns an error if the file cannot be read or parsed

pub fn find_and_load() -> Result<GgenConfig, ConfigError>

Find and load ggen.toml from current or parent directories

Searches upward through the directory tree until finding ggen.toml or reaching the filesystem root.

Errors

Returns an error if no ggen.toml is found or if it cannot be parsed

Example

use ggen_config::config_lib::ConfigLoader;

// Searches current directory and parents for ggen.toml
let config = ConfigLoader::find_and_load()?;

pub fn find_config_file() -> Result<PathBuf, ConfigError>

Find ggen.toml by searching current and parent directories

Errors

Returns an error if no configuration file is found

pub fn load_with_env( &self, environment: &str, ) -> Result<GgenConfig, ConfigError>

Load configuration with environment-specific overrides

Arguments

• environment - Environment name (e.g., “development”, “production”)

Errors

Returns an error if the file cannot be read or parsed

pub fn load_with_env_from_map( self, overrides: &[(&str, Value)], ) -> Result<GgenConfig, ConfigError>

Load configuration with environment-specific overrides from a map

Arguments

• overrides - Slice of (environment_name, overrides) tuples

Errors

Returns an error if the config cannot be loaded

Example

use ggen_config::config_lib::ConfigLoader;
use serde_json::json;

let loader = ConfigLoader::new("ggen.toml")?;
let config = loader.load_with_env_from_map(&[("zai", json!({"ai.provider": "zai"}))])?;
assert_eq!(config.ai.map(|a| a.provider), Some("zai".to_string()));

pub fn path(&self) -> &Path

Get the config file path