Crate config_file2

config-file2

Extremely easy to load and store your configuration file!

Usage

1. Add dependency:

   cargo add config-file2
   

2. Enable which format you want to use in features.
   • all
   • toml (enabled by default)
   • json
   • xml
   • yaml
   • ron

Here’s an example of how to use it with json and yaml format:

[dependencies]
config-file2 = { version = "0.3", features = ["json", "yaml"] }

Examples

use config_file2::{LoadConfigFile, StoreConfigFile};
use serde::{Serialize, Deserialize};

#[derive(Serialize, Deserialize)]
struct Config {
    host: String,
}

// store
Config { host: "example.com".into() }.store("/tmp/myconfig.toml").unwrap();

// load
let config = Config::load("/tmp/myconfig.toml").unwrap();
assert_eq!(config.host.as_str(), "example.com");

more functions

fn load_with_specific_format(path: impl AsRef<Path>, config_type: ConfigFormat) -> Result<Self>;
fn load_or_default(path: impl AsRef<Path>) -> Result<Self>;
fn store_with_specific_format(self, path: impl AsRef<Path>, config_type: ConfigFormat) -> Result<()>;
fn store_without_overwrite(self, path: impl AsRef<Path>) -> Result<()>;

Re-exports

• pub use error::Result;

Modules

• error

Enums

• ConfigFormat
  Format of configuration file.

Traits

• LoadConfigFile
  Trait for loading a struct from a configuration file. This trait is automatically implemented when serde::Deserialize is.
• StoreConfigFile
  Trait for storing a struct into a configuration file. This trait is automatically implemented when serde::Serialize is.