Crate home_config

Usage

use home_config::HomeConfig;

let config = HomeConfig::with_config_dir("app", "config");
// Linux: /home/name/.config/app/config
// macOS: /Users/name/.config/app/config
// Windows: C:\Users\name\.config\app\config

// Write
config.save("123456789").unwrap();

// Read
let data = config.read_to_string().unwrap();
// 123456789

Serde format support

• JSON
• YAML
• TOML
• HCL

home-config = { version = "*", features = ["json", "yaml", "toml", "hcl"] }

A JSON example:

use home_config::HomeConfig;
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize, Default)]
struct People {
    name: String,
    age: u32,
}

let config = HomeConfig::with_file("test.json");
// Linux: /home/name/test.json
// macOS: /Users/name/test.json
// Windows: C:\Users\name\test.json

// Parse
let people = config.json::<People>().unwrap();
// people.name == "XiaoMing";
// people.age == 18;

// Save to file
config.save_json(&people).unwrap();

Structs

HomeConfig

Use the configuration file in the current user directory

Enums

HclError

Serde hcl error

JsonError

Serde json error

TomlParseError

Serde toml parse error

TomlSaveError

Serde toml save error

YamlError

Serde yaml error