A configuration management library.

A configuration file consists of a series of:

• bindings,
• imports,
• and comments.

A binding associates a name to a value:

number = 1
my-string = "Hello"
a_double = 4.0
thatIsABoolean = True
a_double = 5.0
diffTime = 1 day
otherDiffTime = 3 hours

• If two or more bindings have the same name, only the last one is kept.
• Accepted duration values are seconds, minutes, hours, days and weeks.

An import is either required or optional:

import "database.conf"
importMaybe "local.conf"

A comment begins with # and continues to the end of the line:

# Comment
x = 8 # Another comment

From application.conf:

port = 3000
mailFrom = "no-reply@mail.com"
currency = "$"
expiration = 30 minutes

Read the configuration:

import qualified Data.ConfigManager as Conf
import Data.Time.Clock (DiffTime)

data Conf = Conf
  { port :: Int
  , mailFrom :: String
  , currency :: String
  , expiration :: DiffTime
  } deriving (Eq, Show)

getConfig :: IO (Either Text Conf)
getConfig =
  (flip fmap) (Conf.readConfig "application.conf") (\configOrError -> do
    conf <- configOrError
    Conf <$>
      Conf.lookup "port" conf <*>
      Conf.lookup "mailFrom" conf <*>
      Conf.lookup "currency" conf <*>
      Conf.lookup "expiration" conf
  )