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
|
[](https://hackage.haskell.org/package/ini)
[](https://stackage.org/nightly/package/ini)
[](https://www.stackage.org/package/ini)
[](https://github.com/andreasabel/ini/actions/workflows/haskell.yml)
ini
===
Quick and easy configuration files in the INI format for Haskell.
Format rules and recommendations:
* `foo: bar` or `foo=bar` are allowed.
* The `:` syntax is space-sensitive.
* Keys are case-sensitive.
* Lower-case is recommended.
* Values can be empty.
* Keys cannot contain `:`, `=`, `[`, or `]`.
* Comments must start at the beginning of the line with `;` or `#`.
An example configuration file:
``` ini
# Some comment.
[SERVER]
port=6667
hostname=localhost
[AUTH]
user=hello
pass=world
# Salt can be an empty string.
salt=
```
Parsing example:
``` haskell
> parseIni "[SERVER]\nport: 6667\nhostname: localhost"
Right (Ini {unIni = fromList [("SERVER",fromList [("hostname","localhost")
,("port","6667")])]})
```
Extracting values:
``` haskell
> parseIni "[SERVER]\nport: 6667\nhostname: localhost" >>=
lookupValue "SERVER" "hostname"
Right "localhost"
```
Parsing:
``` haskell
> parseIni "[SERVER]\nport: 6667\nhostname: localhost" >>=
readValue "SERVER" "port" decimal
Right 6667
```
Import `Data.Text.Read` to use `decimal`.
## Related packages
[`ini-qq`](https://hackage.haskell.org/package/ini-qq) provides a quasiquoter for INI.
|
