viperus Build Status Coverage Status

̶g̶o̶ rust configuration with fangs!

viperus is an (in)complete configuration solution for Rust applications. inspired heavly inspired by the wonderful go package https://github.com/spf13/viper I have already said that it is incomplete? use at your own risk. ;-)

no Go projects are built using Viperus :-)

What is Viperus?

handle some types of configuration needs and formats. It supports:

Why Viperus?

beacuse I was migrating some go apps... and a was missing Viper ease of use :-)

Viperus uses the following decreasing precedence order.

Viperus merge configuration from toml,dotenv,json,yaml files and clap options in sigle typed hash structure. with defaults, and type checking

you can create a stand alone Viperus object or "enjoy" a global instance ( thread safe protected with a mutex) via shadow functions loadfile|get|add|loadclap that are routed to the static instance.

rust viperus::load_file(".env", viperus::Format::ENV).unwrap(); let ok=viperus::get::<bool>("TEST_BOOL").unwrap(); by the way , Yes I konw globals are evil. but as I was inspired by the evill go pakcge viper.... if you dislike globals you can opt-out disabling in your cargo.toml the feature "global".

logging/debug

the crate uses log facade , and test the env_logger you can set the env variable to RUST=viperus=[DEBUG LEVEL] with [DEBUG LEVEL] = info|warning|debug

Example

you can find some integration tests in the test dir and also in the example forlder you can run example with cargo

cargo run --example cli-clap-yaml -- cargo run --example cli-clap-yaml -- -u http://nowhere/api/v1 the first run print the value from the example.yaml file the second from the cli arg

```rust

let matches = App::new("My Super Program") .arg(Arg::withname("v") .short("v") .multiple(true) .help("Sets the level of verbosity")) .getmatches();

let mut v = Viperus::new();

    v.load_clap(matches);
    v.load_file(&path!(".","assets","test.yaml"), Format::YAML).unwrap();
    v.load_file(&path!(".","assets","test.json"), Format::JSON).unwrap();
    v.load_file(&path!(".","assets","test.toml"), Format::TOML).unwrap();

    v.bond_clap("v","verbose");


    //v.load_file("asset\test.env", Format::JSON).unwrap();
    v.add("service.url", String::from("http://example.com"));
    debug!("final {:?}", v);

    let s: &str = v.get("service.url").unwrap();
    assert_eq!("http://example.com", s);

    let fVerbose=v.get::<bool>("verbose").unwrap();

    assert_eq!(true, fVerbose);

```

Todo