What is it?

The env package is to simplify reading environment variables with e.g. the flag package.

Example:

In our main, we often allow users to initialize our programs via flags. When users leave out the flags, we want to fall back to environment variables. The env package simplifies this scenario.

import (
    "flag"
    "fmt"
)

func main() {
	var (
		// Parse addr from flag, use HTTP_ADDR and ADDR env vars as fallback
		addr = flag.String("addr", env.String("127.0.0.1:3000", "HTTP_ADDR", "ADDR"), "Bind to this address")
	)
	flag.Parse()

	fmt.Println(*addr)
	// Output: 127.0.0.1:3000
}

License

MIT. See LICENSE file.