ini
Configuration files in the INI format.
| LTS Haskell 24.31: | 0.4.2 |
| Stackage Nightly 2026-02-18: | 0.5.1 |
| Latest on Hackage: | 0.5.1 |
Maintained by Jan Hrček
This version can be pinned in stack with:
ini-0.5.1@sha256:50a0c68abfd647c719aacabecf3c1bf5bca1794f825902826d25d9bec5d3618a,1695Module documentation for 0.5.1
- Data
Depends on 4 packages(full list with versions):
Used by 1 package in nightly-2026-02-18(full list with versions):
ini
Quick and easy configuration files in the INI format for Haskell.
Format rules and recommendations:
foo: barorfoo=barare 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:
# Some comment.
[SERVER]
port=6667
hostname=localhost
[AUTH]
user=hello
pass=world
# Salt can be an empty string.
salt=
Parsing example:
> parseIni "[SERVER]\nport: 6667\nhostname: localhost"
Right (Ini {unIni = fromList [("SERVER",fromList [("hostname","localhost")
,("port","6667")])]})
Extracting values:
> parseIni "[SERVER]\nport: 6667\nhostname: localhost" >>=
lookupValue "SERVER" "hostname"
Right "localhost"
Parsing:
> parseIni "[SERVER]\nport: 6667\nhostname: localhost" >>=
readValue "SERVER" "port" decimal
Right 6667
Import Data.Text.Read to use decimal.
Related packages
ini-qq provides a quasiquoter for INI.