dotcfg 0.3.0

Flexible config management for Rust applications
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

//! Basic dotcfg example
//! Run with: `cargo run --example basic`

use dotcfg::DotCfg;
use serde::{Deserialize, Serialize};

#[derive(Debug, Serialize, Deserialize, Default)]
struct AppConfig {
    theme: String,
    language: String,
    notifications: bool,
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Use ~/.myapp/config.toml (default dot strategy)
    let cfg = DotCfg::new("myapp");

    // Save a default config if none exists
    let config: AppConfig = cfg.load_or_default()?;
    println!("Current config: {config:#?}");
    println!("Config file: {:?}", cfg.file_path()?);

    // Update a single key without reloading whole file
    cfg.set("theme", "dark")?;
    println!("theme = {}", cfg.get("theme")?);

    // Show XDG alternative (commented — would use ~/.config/myapp/config.toml)
    // let xdg_cfg = DotCfg::new("myapp").xdg();

    // Same API over YAML — run with `cargo run --example basic --features yaml`
    #[cfg(feature = "yaml")]
    {
        // ~/.myapp/config.yaml
        let ycfg = DotCfg::new("myapp").yaml();
        let yconfig: AppConfig = ycfg.load_or_default()?;
        println!("YAML config: {yconfig:#?}");
        println!("YAML file: {:?}", ycfg.file_path()?);

        ycfg.set("language", "en")?;
        println!("language = {}", ycfg.get("language")?);
    }

    Ok(())
}