7 releases (4 breaking)

Uses new Rust 2021

0.5.1 Oct 25, 2022
0.5.0 Sep 8, 2022
0.4.0 Mar 13, 2020
0.3.1 Dec 6, 2018
0.1.0 Mar 8, 2016

#5 in Configuration

Download history 2640/week @ 2022-08-19 2770/week @ 2022-08-26 2873/week @ 2022-09-02 4577/week @ 2022-09-09 2924/week @ 2022-09-16 3440/week @ 2022-09-23 4077/week @ 2022-09-30 3222/week @ 2022-10-07 2897/week @ 2022-10-14 3831/week @ 2022-10-21 3717/week @ 2022-10-28 4379/week @ 2022-11-04 4830/week @ 2022-11-11 4437/week @ 2022-11-18 4517/week @ 2022-11-25 4837/week @ 2022-12-02

19,353 downloads per month
Used in 99 crates (96 directly)

MIT/X11 OR Apache-2.0

20KB
277 lines

confy

crates.io docs.rs Discord

Zero-boilerplate configuration management.

Focus on storing the right data, instead of worrying about how or where to store it.

use serde_derive::{Serialize, Deserialize};

#[derive(Default, Debug, Serialize, Deserialize)]
struct MyConfig {
    version: u8,
    api_key: String,
}

fn main() -> Result<(), ::std::io::Error> {
    let cfg: MyConfig = confy::load("my-app-name", None)?;
    dbg!(cfg);
    Ok(())
}

Confy's feature flags

Confy can be used with either TOML, YAML, or RON files. TOML is the default language used with confy but any of the other languages can be used by enabling them with feature flags as shown below.

Note: you can only use one of these features at a time, so in order to use either of the optional features you have to disable default features.

Using yaml

To use YAML files with confy you have to make sure you have enabled the yaml_conf feature and disabled both toml_conf and ron_conf.

Enable the feature in Cargo.toml:

[dependencies.confy]
features = ["yaml_conf"]
default-features = false

Using ron

For using RON files with confy you have to make sure you have enabled the ron_conf feature and disabled both toml_conf and yaml_conf.

Enable the feature in Cargo.toml:

[dependencies.confy]
features = ["ron_conf"]
default-features = false

Breaking changes

Version 0.5.0

  • The base functions load and store have been added an optional parameter in the event multiples configurations are needed, or ones with different filename.
  • The default configuration file is now named "default-config" instead of using the application's name. Put the second argument of load and store to be the same of the first one to keep the previous configuration file.
  • It is now possible to save the configuration as toml or as yaml. The configuration's file name's extension depends on the format used.

Version 0.4.0

Starting with version 0.4.0 the configuration file are stored in the expected place for your system. See the directories crates for more information. Before version 0.4.0, the configuration file was written in the current directory.

Dependencies

~0.4–1.4MB
~30K SLoC