#config-parser #config-file #configuration #markup #parser #no-dependencies

superconf

A barebones configuration file made for low-dependency rust applications

7 releases

0.4.3 Nov 15, 2020
0.4.2 Nov 10, 2020
0.3.2 Nov 10, 2020
0.3.1 Aug 30, 2020
0.1.2 Jun 11, 2020

#795 in Configuration

23 downloads per month

MIT license

14KB
176 lines

superconf

A barebones configuration file made for low-dependency rust applications.

Usage

Add to your Cargo.toml file:

[dependancies]
superconf = "0.4"

Examples

Default seperator (space ) demonstration:

use superconf;

let input = "my_key my_value";

println!("{:#?}", superconf::parse(input).unwrap());

Or if you'd like to use a custom seperator like : or =:

use superconf::parse_custom_sep;

let input_equal = "custom=seperator";
let input_colon = "second:string";

println!("Equals seperator: {:#?}", parse_custom_sep(input_equal, '=').unwrap());
println!("Colon seperator: {:#?}", parse_custom_sep(input_colon, ':').unwrap());

Here is a complete syntax demonstration:

# comments are like this
# no seperators are allowed in keys or values
# comments can only be at the start of lines, no end of line comments here

# my_key is the key, my_value is the value
my_key the_value

# you can use seperators as plaintext, just have to be backslashed
your_path /home/user/Cool\ Path/x.txt

Config Conventions

Some conventions commonly used for superconf files:

  • The file naming scheme is snake_case
  • Try to document each line with a comment
  • If commented, space each config part with an empty line seperating it from others. If it is undocumented, you may bunch all config parts together

Motivations

Original motivations for creating

Made this as a quick custom parser to challenge myself a bit and to use for a quick-n-dirty configuration format in the future. It's not the best file format in the world but it gets the job done.

Current/future motivations for maintaining

Maintaining: This library is now being used inside of my ipeer p2p implementation for all .ipeer files so maintaining this library is critical.

No runtime deps