6 releases

0.1.6 Feb 11, 2024
0.1.5 Feb 11, 2024
0.1.2 Jul 24, 2022
0.1.1 Apr 26, 2022

#223 in Configuration

Download history 25/week @ 2024-09-23 11/week @ 2024-09-30 10/week @ 2024-10-07 4/week @ 2024-10-14 23/week @ 2024-11-04 8/week @ 2024-11-18 9/week @ 2024-12-02 31/week @ 2024-12-09 31/week @ 2024-12-16 4/week @ 2024-12-23 13/week @ 2024-12-30 15/week @ 2025-01-06

67 downloads per month
Used in 2 crates

GPL-2.0 license

22KB
248 lines

libset

A configuration file management library for Rust applications.

Add the library

Run cargo add libset or add it to Cargo.toml:

[dependencies]
libset = "0.1"

Usage

Start by creating a new Config object:

let config = Config::new("org.example.Demo", 1, None)?;

Provide an application name, a version and optionally a prefix, then, a new directory will be added to your filesystem, this is where all the created files will be stored in.

Write a file.

let config = Config::new("org.example.Demo", 1, None)?;
config.set_json("colors", json!({ "accent": "#7a7af9" }))?;

This wil store the file here: $HOME/.config/org.example.Demo/v1/colors.json

Get a file.

#[derive(Debug, Serialize, Deserialize)]
struct Colors { accent: String }
let settings: Colors = config.get_json("colors")?;

Check out the examples!

Scopes

A scope is just a simple sub-directory stored inside your application's config directory, all subsequent files will be stored within that scope.

let config = Config::new("org.example.Demo", 1, Some("appearance"))?;
config.set_json("colors", json!({ "accent": "#7a7af9" }))?;

This wil store the file here: $HOME/.config/org.example.Demo/v1/appearance/colors.json

Available features

  • json - Enables json support, enabled by default.
  • toml - Enables toml support.
  • ron - Enables ron support.

Depending on which features you enable, you will get setter and getters methods suffixed by the file type.

Proposals

If you have a proposal for a new feature, open a new issue.

Dependencies

~2–13MB
~158K SLoC