config

Overview ¶

Package config implements simple TOML-based configuration variables, based on the flag package in the standard Go library (In fact, it's just a simple wrapper around flag.FlagSet). It is used in a similar manner, minus the usage strings and other command-line specific bits.

Usage:

Given the following TOML file:

country = "USA"

[atlanta]
enabled = true
population = 432427
temperature = 99.6

Define your config variables and give them defaults:

import "github.com/stvp/go-toml-config"

var (
	country            = config.String("country", "Unknown")
	atlantaEnabled     = config.Bool("atlanta.enabled", false)
	alantaPopulation   = config.Int("atlanta.population", 0)
	atlantaTemperature = config.Float("atlanta.temperature", 0)
)

After all the config variables are defined, load the config file to overwrite the default values with the user-supplied config settings:

if err := config.Parse("/path/to/myconfig.conf"); err != nil {
	panic(err)
}

You can also create separate ConfigSets for different config files:

networkConfig = config.NewConfigSet("network settings", config.ExitOnError)
networkConfig.String("host", "localhost")
networkConfig.Int("port", 8080)
networkConfig.Parse("/path/to/network.conf")