v1.0.1

What's Changed

• Update Go version to 1.22.1 (security)

v1.0.0

Caution

This release includes breaking changes. Please read these release notes thoroughly.

New features

• Introduce global and cascading configuration options by @sethvargo in #97

  This introduces the concept of global configurations and cascades struct-level configuration options onto all child fields. For example, marking a struct as required will mark all child fields as required. Similarly, setting a custom delimiter on a struct tag propagates that delimiter to all child fields of the struct. This behavior previously only applied to the noinit tag, but it now applies to all tags.

Breaking changes

• Change MutatorFunc to be more flexible by @sethvargo in #92 and #94

  ⚠️ BREAKING! This changes the signature of the MutatorFunc to have more information about prior states. It will include the original environment variable names and values, as well as the currently resolved values. Additionally, the mutation chain can now be stopped without returning an error.

• Require Go 1.21 or later by @sethvargo in #93

  ⚠️ BREAKING! The new minimum required Go version is 1.21.

• Drop ExtractDefaults functionality by @sethvargo in #95

  ⚠️ BREAKING! This removes the ExtractDefaults function. It was rarely used and resulted in extraneous processing. Users who depended on this functionality can call ProcessWith an empty MapLookuper (which is all ExtractDefaults did anyway).

• Ignore prefix computing environment variable defaults by @sethvargo in #99

  ⚠️ BREAKING! Computing the default value for an environment variable when the default value is another environment variable will ignore any prefixes on the current lookuper. See #85 for more information.

• Allow configurable decoding by @sethvargo in #100

  ⚠️ BREAKING! Envconfig no longer runs decoders or mutators on unset values. To restore the old behavior, add the decodeunset struct field annotation or pass the DefaultDecodeUnset configuration option as true. See #100 for more information.

Full Changelog: v0.9.0...v1.0.0-beta1

v1.0.0-beta1

This is now released as v1.0.0. There are no changes between v1.0.0 and this release.

v0.9.0

What's Changed

• Allow noinit to apply to slices, maps, and unsafe pointers by @sethvargo in #83

Full Changelog: v0.8.3...v0.9.0

v0.8.2

What's Changed

• Track pointer initialization for zero values by @sethvargo in #73
• Drop regexp for performance by @sethvargo in #74

Full Changelog: v0.8.1...v0.8.2

v0.8.1

What's Changed

• Propagate noinit from parent fields by @sethvargo in #67
• Always call decoders by @sethvargo in #68

Full Changelog: v0.8.0...v0.8.1

v0.8.0

What's Changed

The previous implementation of overwrite would always overwrite values in the given struct, even if values existed. While this is the definition of overwrite, it unintentionally extended to default values as well. So even if a value was explicitly set on a struct, it would be overwritten with the "default" value set in envconfig. This was an unexpected behavior, since defaults should take the lowest precedence.

The new implementation has the following behavior with overwrite:

• If the struct field has the zero value and a default is set:

  • If no environment variable is specified, the struct field will be populated with the default value.

  • If an environment variable is specified, the struct field will be populate with the environment variable value.

• If the struct field has a non-zero value and a default is set:

  • If no environment variable is specified, the struct field's existing value will be used (the default is ignored).

  • If an environment variable is specified, the struct field's existing value will be overwritten with the environment variable value.

As part of this change, decoder interfaces are only processed when an environment (or a default) is present.

Full Changelog: v0.7.0...v0.8.0

v0.7.0

What's Changed

• Change custom unmarshaling order by @gust1n in #59. This changes the order of resolution for unmarshalling to:

  1. envconfig.Decoder
  2. encoding.TextUnmarshaler
  3. json.Unmarshaler
  4. encoding.BinaryUnmarshaler
  5. gob.GobDecoder

New Contributors

• @gust1n made their first contribution in #59

Full Changelog: v0.6.2...v0.7.0

v0.6.2

What's Changed

• Fixing struct pointer initialization with no values set by @williamgcampbell in #57

New Contributors

• @williamgcampbell made their first contribution in #57

Full Changelog: v0.6.1...v0.6.2

v0.6.1

What's Changed

• Sort struct fields for reduce memory by @zchee in #51
• Fix GitHub Actions badge url and query by @zchee in #52
• Fix typo in README.md by @ucpr in #53
• Extend noinit to all pointer fields by @sethvargo in #55

New Contributors

• @zchee made their first contribution in #51
• @ucpr made their first contribution in #53

Full Changelog: v0.6.0...v0.6.1