taciogt / envtags Goto Github PK

It should be possible to set the values of a field that is a struct, executing the same rules applied for the fields on the original struct. This assignment must work for inner structs that are value or pointer fields.

To provides more flexibility, it would be nice to configure some kind of prefix on the environment variables to avoid conflicts when there are more than one field of the same type.

Parse the remaining primitive types:

• float64
• complex64
• complex128
• byte
• rune

Know how to parse environment variables to all possible signed integer types: int8, int16, int32 and int64.
The parser should properly handle errors like

• invalid strings ("1.2" or even "two")
• value greater than maximum or minimum available

Since rune type is just an alias for the int32 type, is a little confusing to parse environment variables in a reliable and consistent way for both of them.
To avoid create unpedictable behaviour, the int32 behaviour should be the default (the parsing works the same way that works for other integers). When the field is a rune and may receive a character from an environment variable, it should have a specific struct tag to signal that.

Suggestion

type Config struct {
  RuneField rune `env:"RUNE_FIELD,rune"`
}

For fields containing the env tag, but without a name for the variable, use a default name by using the CAPITALIZED_SNAKE_CASE version of the field name.

• bool
• string
• byte // alias for uint8
• rune // alias for int32
• float32
• float64
• complex64
• complex128

Create some fuzz testing for integer type fields

https://go.dev/security/fuzz/

There should be possible to set some environment variable to be required: if it is not set an error should be returned