A minimalist Go configuration library
fig is a tiny library for loading an application's configuration into a Go struct.
Time, Duration, Regexp, or any custom type that satisfies the StringUnmarshaler interface.yaml, json, and toml file formats.$ go get -d github.com/kkyr/fig
Define your config file:
# config.yaml
build: "2020-01-09T12:30:00Z"
server:
ports:
- 8080
cleanup: 1h
logger:
level: "warn"
trace: trueDefine your struct along with validations or defaults:
…Fields marked as required are checked to ensure they're not empty, and default values are applied to fill in those that are empty.
By default, fig will only look for values in a config file. To also include values from the environment, use the UseEnv option:
fig.Load(&cfg, fig.UseEnv("APP_PREFIX"))In case of conflicts, values from the environment take precedence.
See usage examples.
For detailed documentation, visit go.dev.
PRs are welcome! Please explain your motivation for the change in your PR and ensure your change is properly tested and documented.
No open issues yet, or sync has not completed.