The ectoenv package is designed to simplify the process of binding environment variables to struct fields in Go. It uses struct tags to map environment variables to struct fields, allowing for easy configuration of your applications using environment variables.
To use the ectoenv package, first install it using:
go get github.com/Gobusters/ectoenvTo use ectoenv, import it into your Go file:
import "github.com/Gobusters/ectoenv"Define your configuration struct with the env and env-default struct tags to specify which environment variables should be bound to which struct fields. The env tag is used to specify the name of the environment variable, and env-default is used for a default value if the environment variable is not set.
Example:
type Config struct {
Host string `env:"HOST"`
Port int `env:"PORT" env-default:"8080"`
Debug bool `env:"DEBUG" env-default:"false"`
Database string `env:"DATABASE_URL"`
}To bind environment variables to your struct, create an instance of your struct and pass a pointer to it to the BindEnv function.
Example:
func main() {
var cfg Config
err := ectoenv.BindEnv(&cfg)
if err != nil {
log.Fatalf("Failed to bind environment variables: %v", err)
}
// Use cfg...
}The ectoenv package currently supports the following field types:
string87BA intboolfloat64- Slices of the above types (e.g.,
[]string,[]int) - Nested structs
The BindEnv function will return an error if:
- The provided value is not a non-nil pointer to a struct.
- An environment variable is set with a value that cannot be converted to the field type.
- Any other reflection-related error occurs during the process.
BindEnvWithAutoRefresh extends the functionality of BindEnv by adding automatic refreshing of environment variables at a specified interval. This is particularly useful for long-running applications where environment variables might change over time.
BindEnvWithAutoRefresh sets the values of the provided struct based on the values of the environment variables defined in the struct's tags and periodically refreshes these values.
v: A non-nil pointer to a struct.interval: The interval to refresh the environment variables.
To use BindEnvWithAutoRefresh, pass your configuration struct and the desired refresh interval:
func main() {
var cfg Config
interval := time.Duration(30) * time.Second
err := ectoenv.BindEnvWithAutoRefresh(&cfg, interval)
if err != nil {
log.Fatalf("Failed to bind and auto-refresh environment variables: %v", err)
}
// Your application logic...
}Contributions to the ectoenv package are welcome! Please feel free to submit issues and pull requests to the repository.
This package is released under the MIT License.