#config #serde #deserialize #universal-config #config-loader

universal-config

A library to simplify reading configuration files from various file formats

11 releases

new 0.5.1 Apr 14, 2025
0.5.0 Mar 30, 2024
0.4.3 Aug 30, 2023
0.4.2 Jul 3, 2023
0.3.0 Mar 26, 2023

#2474 in Parser implementations

Download history 93/week @ 2024-12-23 61/week @ 2024-12-30 70/week @ 2025-01-06 77/week @ 2025-01-13 78/week @ 2025-01-20 99/week @ 2025-01-27 102/week @ 2025-02-03 99/week @ 2025-02-10 114/week @ 2025-02-17 129/week @ 2025-02-24 113/week @ 2025-03-03 96/week @ 2025-03-10 138/week @ 2025-03-17 113/week @ 2025-03-24 118/week @ 2025-03-31 159/week @ 2025-04-07

546 downloads per month
Used in 3 crates

MIT license

18KB
308 lines

Universal Config

crate | docs | repo

Universal Config is a library for Rust to simplify reading and writing configuration files. It is able to automatically locate config files from standard locations, and has support for various file formats.

The crate does not offer a lot of functionality, leaving that to Serde and your implementation. Instead, it just deals with loading and saving the file.

Currently, the following formats are supported:

  • JSON via serde_json
  • YAML via serde_yaml
  • TOML via toml
  • XML via serde_xml_rs
  • Corn via libcorn
  • Ron via ron

Installation

Just add the crate:

cargo add universal-config

By default, support for all languages is included. You can enable/disable languages using feature flags. For example, in your Cargo.toml:

[dependencies.universal-config]
version = "0.1.0"
default-features = false
features = ["json", "toml"]

Example usage

use universal_config::ConfigLoader;
use serde::Deserialize;

#[derive(Deserialize)]
struct MyConfig {
    foo: String,
}

fn main() {
    let config: MyConfig = ConfigLoader::new("my-app").find_and_load().unwrap();
    println!("{}", config.foo);
}

For more advanced usage, please check the docs.

Dependencies

~1–13MB
~105K SLoC