lib_config 0.2.0

Simple and intuitive API to create and access JSON config files
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

# `lib_config`

JSON Configuration Library in Rust

## Usage


#### Dependency


Copy into your `[dependencies]` section of your Cargo.toml file

```toml
lib_config = "0.1.0"
```

#### Example


Code taken from the tests

```rust
//example: open (or create) a config, then write and read a value
    {
        let mut conf = config::open_from_home(".lib_config", "conftest.json").unwrap();

        conf.write_value("val0", 100).unwrap();
        let val0: i32 = conf.read_value("val0").unwrap();

        assert_eq!(val0, 100);

        conf.save().unwrap();
    }

//example: create & write a config section
    {
        let mut conf = config::open_from_home(".lib_config", "conftest.json").unwrap();

        conf.write_value("sect0", json!({
            "val0" : 10,
            "val1" : "foo"
        })).unwrap();

        conf.save().unwrap();
    }

///example: get and read from config section
    {
        let conf = config::open_from_home(".lib_config", "conftest.json").unwrap();

        let sect0 = conf.get_section("sect0").unwrap();
        let val0 : i32 = sect0.read_value("val0").unwrap();
        let val1: String = sect0.read_value("val1").unwrap();

        assert_eq!(val0, 10);
        assert_eq!(val1, String::from("foo"));
    }
```

The resulting config file will be

```json
  {
    "sect0": {
      "val0": 10,
      "val1": "foo"
    },
    "val0": 100
  }
```

## Licence 


Licenced under

 * MIT license
   ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)