#ini #configuration #cfg #conf #openvdi

ov-config

An ini/toml configuration parsing library that provide macros and convenience functions for generating configuration schema, sanity check, flush, refresh, etc

2 releases

0.1.1 Jul 14, 2019
0.1.0 Jul 14, 2019

#729 in Configuration

Apache-2.0

26KB
460 lines

ov-config

Build Status

A configuration parsing library that provide macros and convenience functions for generating configuration schema, sanity check, flush, refresh, etc. Design for .toml and .ini.

Usage

  • Create Configuration Schema
extern crate ov_config;

use ov_config::*;

make_config!(
	TestConfig,
	SECTION1 {
		//key: Type: Default Value => Verification closure
	    a_string: String: "key1".into() => |x: &String| x.len() > 0,
	    a_vector: Vec<i32>: vec![1, 2, 3] => |x: &Vec<i32>| x.len() < 4
	};
	// Support for multi section per config
	SECTION2 {
	    a_i32: i32: 15 => |x: &i32| *x < 20,
	    a_bool: bool: true => |_| true
	}
);

fn main() {
	let config = TestConfig{..Default::default()};
	assert_eq!(config.SECTION1.a_string, "key1");
	assert_eq!(config.SECTION1.a_vector, vec![1, 2, 3]);
	assert_eq!(config.SECTION2.a_i32, 15);
	assert_eq!(config.SECTION2.a_bool, true);
}
  • Get config from file -- will automatcially do sanity check on each value.
extern crate ov_config;

use ov_config::*;
use std::fs::File;
use std::io::prelude::*;

make_config!(
	TestConfig,
	SECTION1 {
		//key: Type: Default Value => Verification closure
	    a_string: String: "key1".into() => |x: &String| x.len() > 0,
	    a_vector: Vec<i32>: vec![1, 2, 3] => |x: &Vec<i32>| x.len() < 4
	};
	// Support for multi section per config
	SECTION2 {
	    a_i32: i32: 15 => |x: &i32| *x < 20,
	    a_bool: bool: true => |_| true
	}
);

fn main() {
	let config = r#"
        [SECTION1]
        a_string: i_am_a_string
        a_vector: [1, 2, 3]
        [SECTION2]
        a_i32: 12
        a_bool: true
    "#;

    let mut file = File::create("PATH_TO_CONFIG.ini").unwrap();
    file.write_all(config.as_bytes()).unwrap();
    file.sync_all().unwrap();

    let config = TestConfig::get_config("PATH_TO_CONFIG.ini").unwrap();

    assert_eq!(config.SECTION1.a_string, "i_am_a_string");
    assert_eq!(config.SECTION1.a_vector, [1, 2, 3]);
    assert_eq!(config.SECTION2.a_i32, 12);
    assert_eq!(config.SECTION2.a_bool, true);
}

More details could be found from the documentation.

Dependencies

~0.5–1MB
~20K SLoC