mirror of
https://github.com/Luzifer/rconfig.git
synced 2024-11-09 00:10:07 +00:00
94 lines
2.9 KiB
Markdown
94 lines
2.9 KiB
Markdown
[](https://travis-ci.org/Luzifer/rconfig)
|
|
[](https://goreportcard.com/report/github.com/Luzifer/rconfig)
|
|
[](https://godoc.org/github.com/Luzifer/rconfig)
|
|
|
|
[](https://gopkg.in/Luzifer/rconfig.v2)
|
|
|
|
## Description
|
|
|
|
> Package rconfig implements a CLI configuration reader with struct-embedded defaults, environment variables and posix compatible flag parsing using the [pflag](https://github.com/spf13/pflag) library.
|
|
|
|
## Installation
|
|
|
|
Install by running:
|
|
|
|
```
|
|
go get -u github.com/Luzifer/rconfig
|
|
```
|
|
|
|
OR fetch a specific version:
|
|
|
|
```
|
|
go get -u gopkg.in/luzifer/rconfig.v2
|
|
```
|
|
|
|
Run tests by running:
|
|
|
|
```
|
|
go test -v -race -cover github.com/Luzifer/rconfig
|
|
```
|
|
|
|
## Usage
|
|
|
|
A very simple usecase is to just configure a struct inside the vars section of your `main.go` and to parse the commandline flags from the `main()` function:
|
|
|
|
```go
|
|
package main
|
|
|
|
import (
|
|
"fmt"
|
|
"github.com/Luzifer/rconfig"
|
|
)
|
|
|
|
var (
|
|
cfg = struct {
|
|
Username string `default:"unknown" flag:"user" description:"Your name"`
|
|
Details struct {
|
|
Age int `default:"25" flag:"age" env:"age" description:"Your age"`
|
|
}
|
|
}{}
|
|
)
|
|
|
|
func main() {
|
|
rconfig.Parse(&cfg)
|
|
|
|
fmt.Printf("Hello %s, happy birthday for your %dth birthday.",
|
|
cfg.Username,
|
|
cfg.Details.Age)
|
|
}
|
|
```
|
|
|
|
In Go 1.11 support for Go modules was added. To import the current version using Go modules use this import:
|
|
|
|
```go
|
|
import rconfig "github.com/Luzifer/rconfig/v2"
|
|
```
|
|
|
|
### Provide variable defaults by using a file
|
|
|
|
Given you have a file `~/.myapp.yml` containing some secrets or usernames (for the example below username is assumed to be "luzifer") as a default configuration for your application you can use this source code to load the defaults from that file using the `vardefault` tag in your configuration struct.
|
|
|
|
The order of the directives (lower number = higher precedence):
|
|
|
|
1. Flags provided in command line
|
|
1. Environment variables
|
|
1. Variable defaults (`vardefault` tag in the struct)
|
|
1. `default` tag in the struct
|
|
|
|
```go
|
|
var cfg = struct {
|
|
Username string `vardefault:"username" flag:"username" description:"Your username"`
|
|
}
|
|
|
|
func main() {
|
|
rconfig.SetVariableDefaults(rconfig.VarDefaultsFromYAMLFile("~/.myapp.yml"))
|
|
rconfig.Parse(&cfg)
|
|
|
|
fmt.Printf("Username = %s", cfg.Username)
|
|
// Output: Username = luzifer
|
|
}
|
|
```
|
|
|
|
## More info
|
|
|
|
You can see the full reference documentation of the rconfig package [at godoc.org](https://godoc.org/github.com/Luzifer/rconfig), or through go's standard documentation system by running `godoc -http=:6060` and browsing to [http://localhost:6060/pkg/github.com/Luzifer/rconfig](http://localhost:6060/pkg/github.com/Luzifer/rconfig) after installation.
|