go-envconfig | Go Ecosystem Directory

Bot releases are visible (Hide)

go-envconfig - v1.0.3 Latest Release

Published by sethvargo 5 months ago

What's Changed

Relax Go constraint to 1.20 by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/113

Full Changelog: https://github.com/sethvargo/go-envconfig/compare/v1.0.2...v1.0.3

go-envconfig - v1.0.2

Published by sethvargo 5 months ago

What's Changed

Fix docs by @ucpr in https://github.com/sethvargo/go-envconfig/pull/105
Fix README example code comment by @katsuharu in https://github.com/sethvargo/go-envconfig/pull/106
Handle case where user accidentally uses Process() with a Config when… by @pdewilde in https://github.com/sethvargo/go-envconfig/pull/109
Fix docs by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/110

New Contributors

@katsuharu made their first contribution in https://github.com/sethvargo/go-envconfig/pull/106
@pdewilde made their first contribution in https://github.com/sethvargo/go-envconfig/pull/109

Full Changelog: https://github.com/sethvargo/go-envconfig/compare/v1.0.1...v1.0.2

go-envconfig - v1.0.1

Published by sethvargo 8 months ago

What's Changed

Update Go version to 1.22.1 (security)

go-envconfig - v1.0.0

Published by sethvargo 10 months ago

[!CAUTION]

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

New features

Introduce global and cascading configuration options by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/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 https://github.com/sethvargo/go-envconfig/pull/92 and https://github.com/sethvargo/go-envconfig/pull/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 https://github.com/sethvargo/go-envconfig/pull/93

⚠️ BREAKING! The new minimum required Go version is 1.21.
Drop ExtractDefaults functionality by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/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 https://github.com/sethvargo/go-envconfig/pull/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 https://github.com/sethvargo/go-envconfig/pull/85 for more information.
Allow configurable decoding by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/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 https://github.com/sethvargo/go-envconfig/pull/100 for more information.

Full Changelog: https://github.com/sethvargo/go-envconfig/compare/v0.9.0...v1.0.0-beta1

go-envconfig - v1.0.0-beta1

Published by sethvargo 10 months ago

[!CAUTION]

This release includes breaking changes to prepare for the 1.0 release. Please read these release notes thoroughly and report any bugs or issues. Many of these "breaking changes" are fixing what should have been the correct behavior from the start.

New features

Introduce global and cascading configuration options by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/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 https://github.com/sethvargo/go-envconfig/pull/92 and https://github.com/sethvargo/go-envconfig/pull/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 https://github.com/sethvargo/go-envconfig/pull/93

⚠️ BREAKING! The new minimum required Go version is 1.21.
Drop ExtractDefaults functionality by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/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 https://github.com/sethvargo/go-envconfig/pull/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 https://github.com/sethvargo/go-envconfig/pull/85 for more information.
Allow configurable decoding by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/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 https://github.com/sethvargo/go-envconfig/pull/100 for more information.

Full Changelog: https://github.com/sethvargo/go-envconfig/compare/v0.9.0...v1.0.0-beta1

go-envconfig - v0.9.0

Published by sethvargo over 1 year ago

What's Changed

Allow noinit to apply to slices, maps, and unsafe pointers by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/83

Full Changelog: https://github.com/sethvargo/go-envconfig/compare/v0.8.3...v0.9.0

go-envconfig - v0.8.2

Published by sethvargo about 2 years ago

What's Changed

Track pointer initialization for zero values by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/73
Drop regexp for performance by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/74

Full Changelog: https://github.com/sethvargo/go-envconfig/compare/v0.8.1...v0.8.2

go-envconfig - v0.8.1

Published by sethvargo about 2 years ago

What's Changed

Propagate noinit from parent fields by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/67
Always call decoders by @sethvargo in https://github.com/sethvargo/go-envconfig/pull/68

Full Changelog: https://github.com/sethvargo/go-envconfig/compare/v0.8.0...v0.8.1

go-envconfig - v0.8.0

Published by sethvargo over 2 years ago

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: https://github.com/sethvargo/go-envconfig/compare/v0.7.0...v0.8.0

go-envconfig - v0.7.0

Published by sethvargo over 2 years ago

What's Changed

Change custom unmarshaling order by @gust1n in https://github.com/sethvargo/go-envconfig/pull/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