tini 0.1.1

A tiny ini parsing library, written in Rust
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

# tini — A tiny INI parsing library, written in Rust

[![Gitter](https://badges.gitter.im/pinecrew/tiny-ini.svg)](https://gitter.im/pinecrew/tiny-ini?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Build Status](https://travis-ci.org/pinecrew/tini.svg?branch=master)](https://travis-ci.org/pinecrew/tini)

| [Documentation](http://pinecrew.github.io/tini/tini/) |
[Examples](./examples) |

## Usage

Add `tini` to your `Cargo.toml`, for example:
```
[dependencies]
tini = "0.1"
```

## How to use

#### Read ini configuration from file

```rust
extern crate tini;
use tini::Ini;

fn main() {
    // Read example.ini file from examples directory
    let config = Ini::from_file("./examples/example.ini").unwrap();
    // Read name3 key from section_one
    let name3: String = config.get("section_one", "name3").unwrap();
    // Read list of values
    let frst4: Vec<u8> = config.get("section_three", "frst4").unwrap();
    println!("name3 = {}", name3);
    println!("frst4 = {}", frst4);
    // Result:
    // name3 = example text
    // frst4 = true, false, true
}
```

#### Create ini configuration and write to file

```rust
extern crate tini;
use tini::Ini;

fn main() {
    // Create ini structure
    let conf = Ini::new()                                // initialize Ini
                   .section("params")                    // create `params` section
                   .item("pi", "3.14")                   // add `pi` key
                   .item("lost", "4, 8, 15, 16, 23, 42") // add `lost` list
                   .section("other")                     // create another section
                   .item("default", "hello world!");     // add `default` key to `other` section
    // At any time you can add new parameters to the last created section
    // < some code >
    // Now write ini structure to file
    conf.to_file("output.ini").unwrap();
    // Now `output.ini` contains
    // -----------------------------
    // [other]
    // default = hello world!
    // [params]
    // pi = 3.14
    // lost = 4, 8, 15, 16, 23, 42
    // -----------------------------
}
```

See more in [examples](./examples) folder or in [documentation](http://pinecrew.github.io/tini/tini/).