Documentation ¶
Overview ¶
Package cleanenv gives you a single tool to read application configuration from several sources.
You can just prepare config structure and fill it from the config file and environment variables.
type Config struct { Port string `yml:"port" env:"PORT" env-default:"8080"` Host string `yml:"host" env:"HOST" env-default:"localhost"` } var cfg Config ReadConfig("config.yml", &cfg)
Index ¶
Examples ¶
Constants ¶
const (
// DefaultSeparator is a defauld list and map separator character
DefaultSeparator = ","
)
Variables ¶
This section is empty.
Functions ¶
func GetDescription ¶
GetDescription returns a description of environment variables. You can provide a custom header text.
Example ¶
ExampleGetDescription builds a description text from structure tags
package main import ( "fmt" "github.com/ilyakaznacheev/cleanenv" ) func main() { type config struct { One int64 `env:"ONE" env-description:"first parameter"` Two float64 `env:"TWO" env-description:"second parameter"` Three string `env:"THREE" env-description:"third parameter"` } var cfg config text, err := cleanenv.GetDescription(&cfg, nil) if err != nil { panic(err) } fmt.Println(text) }
Output: Environment variables: ONE int64 first parameter TWO float64 second parameter THREE string third parameter
Example (Custom_header_text) ¶
ExampleGetDescription_custom_header_text builds a description text from structure tags with custom header string
package main import ( "fmt" "github.com/ilyakaznacheev/cleanenv" ) func main() { type config struct { One int64 `env:"ONE" env-description:"first parameter"` Two float64 `env:"TWO" env-description:"second parameter"` Three string `env:"THREE" env-description:"third parameter"` } var cfg config header := "Custom header text:" text, err := cleanenv.GetDescription(&cfg, &header) if err != nil { panic(err) } fmt.Println(text) }
Output: Custom header text: ONE int64 first parameter TWO float64 second parameter THREE string third parameter
Example (Defaults) ¶
ExampleGetDescription_defaults builds a description text from structure tags with description of default values
package main import ( "fmt" "github.com/ilyakaznacheev/cleanenv" ) func main() { type config struct { One int64 `env:"ONE" env-description:"first parameter" env-default:"1"` Two float64 `env:"TWO" env-description:"second parameter" env-default:"2.2"` Three string `env:"THREE" env-description:"third parameter" env-default:"test"` } var cfg config text, err := cleanenv.GetDescription(&cfg, nil) if err != nil { panic(err) } fmt.Println(text) }
Output: Environment variables: ONE int64 first parameter (default "1") TWO float64 second parameter (default "2.2") THREE string third parameter (default "test")
Example (Variable_list) ¶
ExampleGetDescription_variable_list builds a description text from structure tags with description of alternative variables
package main import ( "fmt" "github.com/ilyakaznacheev/cleanenv" ) func main() { type config struct { FirstVar int64 `env:"ONE,TWO,THREE" env-description:"first found parameter"` } var cfg config text, err := cleanenv.GetDescription(&cfg, nil) if err != nil { panic(err) } fmt.Println(text) }
Output: Environment variables: ONE int64 first found parameter TWO int64 (alternative to ONE) first found parameter THREE int64 (alternative to ONE) first found parameter
func ReadConfig ¶
ReadConfig reads configuration file and parses it depending on tags in structure provided. Then it reads and parses
Example:
type ConfigDatabase struct { Port string `yml:"port" env:"PORT" env-default:"5432"` Host string `yml:"host" env:"HOST" env-default:"localhost"` Name string `yml:"name" env:"NAME" env-default:"postgres"` User string `yml:"user" env:"USER" env-default:"user"` Password string `yml:"password" env:"PASSWORD"` } var cfg ConfigDatabase err := cleanenv.ReadConfig("config.yml", &cfg) if err != nil { ... }
func ReadEnv ¶
func ReadEnv(cfg interface{}) error
ReadEnv reads environment variables into the structure.
Example ¶
ExampleReadEnv reads environment variables or default values into the structure
package main import ( "fmt" "os" "github.com/ilyakaznacheev/cleanenv" ) func main() { type config struct { Port string `env:"PORT" env-default:"5432"` Host string `env:"HOST" env-default:"localhost"` Name string `env:"NAME" env-default:"postgres"` User string `env:"USER" env-default:"user"` Password string `env:"PASSWORD"` } var cfg config os.Setenv("PORT", "5050") os.Setenv("NAME", "redis") os.Setenv("USER", "tester") os.Setenv("PASSWORD", "*****") cleanenv.ReadEnv(&cfg) fmt.Printf("%+v\n", cfg) }
Output: {Port:5050 Host:localhost Name:redis User:tester Password:*****}
func UpdateEnv ¶
func UpdateEnv(cfg interface{}) error
UpdateEnv rereads (updates) environment variables in the structure.
Example ¶
ExampleUpdateEnv updates variables in the configuration structure. Only variables with `env-upd:""` tag will be updated
package main import ( "fmt" "os" "github.com/ilyakaznacheev/cleanenv" ) func main() { type config struct { One int64 `env:"ONE"` Two int64 `env:"TWO" env-upd:""` } var cfg config // set environment variables os.Setenv("ONE", "1") os.Setenv("TWO", "2") // read environment variables into the structure cleanenv.ReadEnv(&cfg) fmt.Printf("%+v\n", cfg) // update environment variables os.Setenv("ONE", "11") os.Setenv("TWO", "22") // update only updatable environment variables in the structure cleanenv.UpdateEnv(&cfg) fmt.Printf("%+v\n", cfg) }
Output: {One:1 Two:2} {One:1 Two:22}
Types ¶
type Setter ¶
Setter is an interface for a custom value setter.
To implement a custom value setter you need to add a SetValue function to your type that will receive a string raw value:
type MyField string func (f *MyField) SetValue(s string) error { if s == "" { return fmt.Errorf("field value can't be empty") } *f = MyField("my field is: " + s) return nil }