You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
4 years ago | |
---|---|---|
.. | ||
ini | 4 years ago | |
timeconv | 4 years ago | |
.gitignore | 4 years ago | |
.travis.yml | 4 years ago | |
LICENSE | 4 years ago | |
README.md | 4 years ago | |
config.go | 4 years ago | |
go.mod | 4 years ago | |
go.sum | 4 years ago | |
listener.go | 4 years ago | |
nocopy.go | 4 years ago | |
source.go | 4 years ago | |
srcfile.go | 4 years ago | |
srcmap.go | 4 years ago |
README.md
cfg
Go package for app configuration. Supports chained configuration sources for multiple levels of defaults. Includes APIs for loading Linux style configuration files (name/value pairs) or INI files, map based properties, or easily create new configuration sources (e.g. load from database).
Supports monitoring configuration sources for changes, hot loading properties, and notifying listeners of changes.
Usage
config := &cfg.Config{}
defer config.Shutdown() // stops monitoring
// load file via filespec string, os.File
src, err := Config.NewSrcFileFromFilespec("./myfile.conf")
if err != nil {
return err
}
// add src to top of chain, meaning first searched
cfg.PrependSource(src)
// fetch prop 'retries', default to 3 if not found
val := config.Int("retries", 3)
See example for more complete example, including listening for configuration changes.
Config API parses the following data types:
type | method | example property values |
---|---|---|
string | Config.String | test, "" |
int | Config.Int | -1, 77, 0 |
int64 | Config.Int64 | -9223372036854775, 372036854775808 |
float64 | Config.Float64 | -77.3456, 95642331.1 |
bool | Config.Bool | T,t,true,True,1,0,False,false,f,F |
time.Duration | Config.Duration | "10ms", "2 hours", "5 min" * |
* Units of measure supported: ms, sec, min, hour, day, week, year.