Release 1.170.4

Changelog

This document contains a history of significant changes which have been released for golang-utils. Please note that
beta releases are not included in this history.

"1.170.4" (2026-08-19)

Bugfixes

• Dependency upgrade: codeql-action-4.37.6 (#20260818152436)

"1.170.3" (2026-08-18)

Bugfixes

• Dependency upgrade: text-0.41.0 (#20260817101501)
• Dependency upgrade: net-0.58.0 (#20260817101511)
• Dependency upgrade: spdx-0.3.1 (#20260817101518)
• Dependency upgrade: testify-1.12.0 (#20260817101526)
• 💥 Restore local required validation rules for remaining HTTP and file cache config fields after the ozzo-validation behaviour change. (#20260817103000)
• Dependency upgrade: stringcase-1.0.0 (#20260818090655)
• Dependency upgrade: logrus-1.10.0 (#20260818101350)

"1.170.2" (2026-08-13)

Bugfixes

• 🐛 annotations Ensure that annotation behavior aligns with what the CI platforms expect with annotations prefixing the entire log line (#20260813115747)

"1.170.1" (2026-08-12)

Bugfixes

• ♻️ [value] Fix a regression introduced by switching flatten-map string conversion to StringConverter by restoring flatten-map scalar formatting, keeping fmt.Stringer and encoding.TextMarshaler precedence, wrapping text-marshalling failures as commonerrors.ErrMarshalling, and documenting pointer and struct fallback output. (#202608121215)
• Dependency upgrade: upload-sarif-c16c0f3f2812ec4bb3750a5ed64873fe2ce0fbef (#20260812101700)

"1.170.0" (2026-08-11)

Features

• ✨ [value] Added context-aware value converters, including IdentityConverter and StringConverter with fmt.Stringer, encoding.TextMarshaler, and fallback string formatting support. (#202608111300)
• ✨ [reflection] Added NewValueTypeConverter to adapt reflection-based converters into the shared value-converter interface. (#202608111301)
• ✨ [config] Added context-aware default-value converters for environment variable generation, including SecretConverter for masking sensitive values. (#202608111302)
• ✨ [reflection] Added helpers to detect field tag values on structs, struct pointers, and collection values containing tagged struct items. (#202608111345)
• 🔒 [config] Added tag-aware configuration masking converters that can automatically obfuscate sensitive values based on common field tags such as mask, sensitive, secret, password, censored, redact, pii, and sens. (#202608111430)

Bugfixes

• Dependency upgrade: upload-sarif-7d9249f5a57288b8a472ddd9cc3ece1921f7dc38 (#20260807125603)

Misc

• #202608111330

"1.169.0" (2026-08-07)

Features

• ✨ [validation] Added when-rule helpers for not-equals, empty, and not-empty checks across property- and field-based validation. (#202608062230)
• ✨ [validation] Added non-recursive value-oriented helpers such as WhenFieldEqualsValue, RequiredFieldsBy, FieldDependencyBy, MutuallyExclusiveFieldsBy, and ForbiddenFieldsBy for clearer cross-field validation. (#202608070910)
• ✨ [validation] Added value-oriented field helpers because property-oriented rules are clearer for maps than structs, and struct Validate() implementations needed readable cross-field validation without recursive helper composition traps. (#202608071000)
• ✨ [validation] Add state-oriented validation rules for zero, emptiness, nil, and legacy required semantics, including a struct-friendly IsRequired that preserves pre-v4.4 ozzo behaviour. (#202608071215)
• 🐛 [validation] Replace safe library uses of raw ozzo validation.Required with the shared state-oriented utils/validation.Required, while keeping intentional non-empty or non-zero cases on ozzo or legacy semantics so zero-valued but present fields are validated consistently. (#202608071730)

Bugfixes

• 🐛 [jsonschema] Default schema options now keep filesystem.NoLimits() while schema validation only requires non-nil limits, so no-limit schemas no longer fail with missing Limits. (#202608062145)
• 🐛 [validation] Added regression coverage pinning the current validation.Required behaviour for zero-valued structs so future ozzo upgrades do not silently change repository validation semantics. (#202608071140)
• 🐛 [validation] Added a state-style Required rule to avoid OpenAPI validation issues where valid zero values such as false and numeric zero were incorrectly excluded, while still rejecting nil values, empty strings, and zero time.Time{}. See utils/validation/state_rules.go for the Required definition. (#202608071235)
• Dependency upgrade: upload-sarif-c1e7c7a0de342c642bc11d2219ba7a3cb2281f19 (#20260707160538)
• Dependency upgrade: timberjack-1.4.6 (#20260804101310)
• Dependency upgrade: v4-4.26.7 (#20260804101341)
• Dependency upgrade: upload-sarif-6a90bf1f5426d0c367cad0b2000f3b721bab3122 (#20260805101538)
• Dependency upgrade: v6-6.0.3 (#20260806101347)
• Dependency upgrade: codeql-action-4.37.5 (#20260806101652)
• Dependency upgrade: v5-5.5.1 (#20260807101334)
• Dependency upgrade: spdx-0.3.0 (#20260807101355)

"1.168.1" (2026-08-04)

Bugfixes

• ♻️ [validation] Time validation now supports optional time.Duration and time.Time pointers consistently, accepts RFC3339 timestamp strings and optional string pointers, and adds a NilTimestampOrNotEmpty helper for optional timestamp fields. (#202607251610)
• Dependency upgrade: codeql-action-4.37.4 (#20260730101302)
• Dependency upgrade: v5-5.5.0 (#20260730101326)
• Dependency upgrade: spdx-0.2.0 (#20260803101237)

"1.168.0" (2026-07-24)

Features

• ✨ [Logs/annotations] add structured CI annotation loggers for GitHub, Azure DevOps, and TeamCity, with adapters for logs.Loggers. (#202607161700)

Bugfixes

• Dependency upgrade: scorecard-action-2.4.4 (#20260724101455)

"1.167.0" (2026-07-23)

Features

• ✨ [Logs/summary] add in-memory and file-backed summary loggers, including GitHub summary support. (#202607161620)
• ✨ [reflection] add helpers for safe reflected property lookup across structs and maps, including JSON-tag-aware field resolution. (#202607161731)
• ✨ [validation] Added JSON-Schema-oriented validation helpers for numbers, strings, arrays, objects, combinators, and property relationships. See https://json-schema.org/understanding-json-schema/. (#20260608114500)
• ✨ [parallelisation] add MapConcurrent, MapConcurrentRef, and MapConcurrentSequence helpers. (#20260707123000)
• Logs: add the logs/summary package with summary loggers and GitHub Actions job summary support. (#20260707143000)

Bugfixes

• 🐛 [validation] Fixed NewNoneRule so it now correctly fails when any nested rule succeeds. (#20260608114600)
• Dependency upgrade: setup-go-7 (#20260716124746)
• Dependency upgrade: codeql-action-4.37.1 (#20260717101309)
• Dependency upgrade: setup-python-7 (#20260720101212)
• Dependency upgrade: logr-1.4.4 (#20260721101310)
• Dependency upgrade: codeql-action-4.37.3 (#20260722101436)

"1.166.1" (2026-07-16)

Bugfixes

• 🐛 [casing] fix regression in acronym-aware casing so normal PascalCase names like NoKeyring do not become NOKeyring (#20260716125731)

"1.166.0" (2026-07-16)

Features

• ✨ [URL] add configurable URL canonicalisation and comparison helpers for normalised matching. (#202607161530)

"1.165.2" (2026-07-15)

Bugfixes

• 🐛 Strings/casing: recognise the codebase's I... interface naming convention when handling acronym-prefixed identifiers such as IHTTP. (#20260707151500)
• 🐛 Strings/casing: improve plural initialism handling so identifiers such as Urls can be normalised to URLs where appropriate. (#20260707151600)
• Dependency upgrade: text-0.40.0 (#20260709101319)
• Dependency upgrade: codeql-action-4.37.0 (#20260709101326)
• Dependency upgrade: net-0.57.0 (#20260709101336)
• Dependency upgrade: crypto-0.54.0 (#20260709101342)
• Dependency upgrade: sync-0.22.0 (#20260709101404)
• Dependency upgrade: sys-0.47.0 (#20260714172504)

"1.165.1" (2026-07-08)

Bugfixes

• 🐛 [casing] fix toPascalCase regression (#20260708165859)

"1.165.0" (2026-07-08)

Features

• ✨ [Retry] add composable retry options with jitter, retry budget, etc. to ease the definition of retry strategies. (#20260707125500)

Bugfixes

• Dependency upgrade: codeql-action-4.36.3 (#20260702101311)
• Dependency upgrade: text-0.39.0 (#20260707101311)
• 🐛 [casing] fix casing helpers so adjacent acronym runs like AESRSA are preserved in existing camelCase and PascalCase identifiers instead of collapsing to Aesrsa. (#20260708153417)

"1.164.1" (2026-07-01)

Bugfixes

• 🐛 [jsonschema] Added support for ignoring YAML alias and anchor helper fields during schema validation when explicitly requested. (#20260608112000)
• Dependency upgrade: crypto-0.53.0 (#20260609101342)
• Dependency upgrade: checkout-7 (#20260619101252)
• Dependency upgrade: cache-6 (#20260624101305)
• Dependency upgrade: upload-sarif-9cea5827c668a1fe7165dbce6e80c3f9cf3f83ac (#20260626101420)
• Dependency upgrade: v4-4.9.0 (#20260629101306)
• Dependency upgrade: v4-4.26.6 (#20260701101231)
• Dependency upgrad...

Release 1.170.3

Changelog

This document contains a history of significant changes which have been released for golang-utils. Please note that
beta releases are not included in this history.

"1.170.3" (2026-08-18)

Bugfixes

• Dependency upgrade: text-0.41.0 (#20260817101501)
• Dependency upgrade: net-0.58.0 (#20260817101511)
• Dependency upgrade: spdx-0.3.1 (#20260817101518)
• Dependency upgrade: testify-1.12.0 (#20260817101526)
• 💥 Restore local required validation rules for remaining HTTP and file cache config fields after the ozzo-validation behaviour change. (#20260817103000)
• Dependency upgrade: stringcase-1.0.0 (#20260818090655)
• Dependency upgrade: logrus-1.10.0 (#20260818101350)

"1.170.2" (2026-08-13)

Bugfixes

• 🐛 annotations Ensure that annotation behavior aligns with what the CI platforms expect with annotations prefixing the entire log line (#20260813115747)

"1.170.1" (2026-08-12)

Bugfixes

• ♻️ [value] Fix a regression introduced by switching flatten-map string conversion to StringConverter by restoring flatten-map scalar formatting, keeping fmt.Stringer and encoding.TextMarshaler precedence, wrapping text-marshalling failures as commonerrors.ErrMarshalling, and documenting pointer and struct fallback output. (#202608121215)
• Dependency upgrade: upload-sarif-c16c0f3f2812ec4bb3750a5ed64873fe2ce0fbef (#20260812101700)

"1.170.0" (2026-08-11)

Features

• ✨ [value] Added context-aware value converters, including IdentityConverter and StringConverter with fmt.Stringer, encoding.TextMarshaler, and fallback string formatting support. (#202608111300)
• ✨ [reflection] Added NewValueTypeConverter to adapt reflection-based converters into the shared value-converter interface. (#202608111301)
• ✨ [config] Added context-aware default-value converters for environment variable generation, including SecretConverter for masking sensitive values. (#202608111302)
• ✨ [reflection] Added helpers to detect field tag values on structs, struct pointers, and collection values containing tagged struct items. (#202608111345)
• 🔒 [config] Added tag-aware configuration masking converters that can automatically obfuscate sensitive values based on common field tags such as mask, sensitive, secret, password, censored, redact, pii, and sens. (#202608111430)

Bugfixes

• Dependency upgrade: upload-sarif-7d9249f5a57288b8a472ddd9cc3ece1921f7dc38 (#20260807125603)

Misc

• #202608111330

"1.169.0" (2026-08-07)

Features

• ✨ [validation] Added when-rule helpers for not-equals, empty, and not-empty checks across property- and field-based validation. (#202608062230)
• ✨ [validation] Added non-recursive value-oriented helpers such as WhenFieldEqualsValue, RequiredFieldsBy, FieldDependencyBy, MutuallyExclusiveFieldsBy, and ForbiddenFieldsBy for clearer cross-field validation. (#202608070910)
• ✨ [validation] Added value-oriented field helpers because property-oriented rules are clearer for maps than structs, and struct Validate() implementations needed readable cross-field validation without recursive helper composition traps. (#202608071000)
• ✨ [validation] Add state-oriented validation rules for zero, emptiness, nil, and legacy required semantics, including a struct-friendly IsRequired that preserves pre-v4.4 ozzo behaviour. (#202608071215)
• 🐛 [validation] Replace safe library uses of raw ozzo validation.Required with the shared state-oriented utils/validation.Required, while keeping intentional non-empty or non-zero cases on ozzo or legacy semantics so zero-valued but present fields are validated consistently. (#202608071730)

Bugfixes

• 🐛 [jsonschema] Default schema options now keep filesystem.NoLimits() while schema validation only requires non-nil limits, so no-limit schemas no longer fail with missing Limits. (#202608062145)
• 🐛 [validation] Added regression coverage pinning the current validation.Required behaviour for zero-valued structs so future ozzo upgrades do not silently change repository validation semantics. (#202608071140)
• 🐛 [validation] Added a state-style Required rule to avoid OpenAPI validation issues where valid zero values such as false and numeric zero were incorrectly excluded, while still rejecting nil values, empty strings, and zero time.Time{}. See utils/validation/state_rules.go for the Required definition. (#202608071235)
• Dependency upgrade: upload-sarif-c1e7c7a0de342c642bc11d2219ba7a3cb2281f19 (#20260707160538)
• Dependency upgrade: timberjack-1.4.6 (#20260804101310)
• Dependency upgrade: v4-4.26.7 (#20260804101341)
• Dependency upgrade: upload-sarif-6a90bf1f5426d0c367cad0b2000f3b721bab3122 (#20260805101538)
• Dependency upgrade: v6-6.0.3 (#20260806101347)
• Dependency upgrade: codeql-action-4.37.5 (#20260806101652)
• Dependency upgrade: v5-5.5.1 (#20260807101334)
• Dependency upgrade: spdx-0.3.0 (#20260807101355)

"1.168.1" (2026-08-04)

Bugfixes

• ♻️ [validation] Time validation now supports optional time.Duration and time.Time pointers consistently, accepts RFC3339 timestamp strings and optional string pointers, and adds a NilTimestampOrNotEmpty helper for optional timestamp fields. (#202607251610)
• Dependency upgrade: codeql-action-4.37.4 (#20260730101302)
• Dependency upgrade: v5-5.5.0 (#20260730101326)
• Dependency upgrade: spdx-0.2.0 (#20260803101237)

"1.168.0" (2026-07-24)

Features

• ✨ [Logs/annotations] add structured CI annotation loggers for GitHub, Azure DevOps, and TeamCity, with adapters for logs.Loggers. (#202607161700)

Bugfixes

• Dependency upgrade: scorecard-action-2.4.4 (#20260724101455)

"1.167.0" (2026-07-23)

Features

• ✨ [Logs/summary] add in-memory and file-backed summary loggers, including GitHub summary support. (#202607161620)
• ✨ [reflection] add helpers for safe reflected property lookup across structs and maps, including JSON-tag-aware field resolution. (#202607161731)
• ✨ [validation] Added JSON-Schema-oriented validation helpers for numbers, strings, arrays, objects, combinators, and property relationships. See https://json-schema.org/understanding-json-schema/. (#20260608114500)
• ✨ [parallelisation] add MapConcurrent, MapConcurrentRef, and MapConcurrentSequence helpers. (#20260707123000)
• Logs: add the logs/summary package with summary loggers and GitHub Actions job summary support. (#20260707143000)

Bugfixes

• 🐛 [validation] Fixed NewNoneRule so it now correctly fails when any nested rule succeeds. (#20260608114600)
• Dependency upgrade: setup-go-7 (#20260716124746)
• Dependency upgrade: codeql-action-4.37.1 (#20260717101309)
• Dependency upgrade: setup-python-7 (#20260720101212)
• Dependency upgrade: logr-1.4.4 (#20260721101310)
• Dependency upgrade: codeql-action-4.37.3 (#20260722101436)

"1.166.1" (2026-07-16)

Bugfixes

• 🐛 [casing] fix regression in acronym-aware casing so normal PascalCase names like NoKeyring do not become NOKeyring (#20260716125731)

"1.166.0" (2026-07-16)

Features

• ✨ [URL] add configurable URL canonicalisation and comparison helpers for normalised matching. (#202607161530)

"1.165.2" (2026-07-15)

Bugfixes

• 🐛 Strings/casing: recognise the codebase's I... interface naming convention when handling acronym-prefixed identifiers such as IHTTP. (#20260707151500)
• 🐛 Strings/casing: improve plural initialism handling so identifiers such as Urls can be normalised to URLs where appropriate. (#20260707151600)
• Dependency upgrade: text-0.40.0 (#20260709101319)
• Dependency upgrade: codeql-action-4.37.0 (#20260709101326)
• Dependency upgrade: net-0.57.0 (#20260709101336)
• Dependency upgrade: crypto-0.54.0 (#20260709101342)
• Dependency upgrade: sync-0.22.0 (#20260709101404)
• Dependency upgrade: sys-0.47.0 (#20260714172504)

"1.165.1" (2026-07-08)

Bugfixes

• 🐛 [casing] fix toPascalCase regression (#20260708165859)

"1.165.0" (2026-07-08)

Features

• ✨ [Retry] add composable retry options with jitter, retry budget, etc. to ease the definition of retry strategies. (#20260707125500)

Bugfixes

• Dependency upgrade: codeql-action-4.36.3 (#20260702101311)
• Dependency upgrade: text-0.39.0 (#20260707101311)
• 🐛 [casing] fix casing helpers so adjacent acronym runs like AESRSA are preserved in existing camelCase and PascalCase identifiers instead of collapsing to Aesrsa. (#20260708153417)

"1.164.1" (2026-07-01)

Bugfixes

• 🐛 [jsonschema] Added support for ignoring YAML alias and anchor helper fields during schema validation when explicitly requested. (#20260608112000)
• Dependency upgrade: crypto-0.53.0 (#20260609101342)
• Dependency upgrade: checkout-7 (#20260619101252)
• Dependency upgrade: cache-6 (#20260624101305)
• Dependency upgrade: upload-sarif-9cea5827c668a1fe7165dbce6e80c3f9cf3f83ac (#20260626101420)
• Dependency upgrade: v4-4.9.0 (#20260629101306)
• Dependency upgrade: v4-4.26.6 (#20260701101231)
• Dependency upgrade: upload-sarif-628fc3f124e68b0151f0d2a5d81e864ee1e42335 (#20260701101351)

"1.164.0" (2026-06-18)

Featu...

Release 1.170.2

Changelog

This document contains a history of significant changes which have been released for golang-utils. Please note that
beta releases are not included in this history.

"1.170.2" (2026-08-13)

Bugfixes

• 🐛 annotations Ensure that annotation behavior aligns with what the CI platforms expect with annotations prefixing the entire log line (#20260813115747)

"1.170.1" (2026-08-12)

Bugfixes

• ♻️ [value] Fix a regression introduced by switching flatten-map string conversion to StringConverter by restoring flatten-map scalar formatting, keeping fmt.Stringer and encoding.TextMarshaler precedence, wrapping text-marshalling failures as commonerrors.ErrMarshalling, and documenting pointer and struct fallback output. (#202608121215)
• Dependency upgrade: upload-sarif-c16c0f3f2812ec4bb3750a5ed64873fe2ce0fbef (#20260812101700)

"1.170.0" (2026-08-11)

Features

• ✨ [value] Added context-aware value converters, including IdentityConverter and StringConverter with fmt.Stringer, encoding.TextMarshaler, and fallback string formatting support. (#202608111300)
• ✨ [reflection] Added NewValueTypeConverter to adapt reflection-based converters into the shared value-converter interface. (#202608111301)
• ✨ [config] Added context-aware default-value converters for environment variable generation, including SecretConverter for masking sensitive values. (#202608111302)
• ✨ [reflection] Added helpers to detect field tag values on structs, struct pointers, and collection values containing tagged struct items. (#202608111345)
• 🔒 [config] Added tag-aware configuration masking converters that can automatically obfuscate sensitive values based on common field tags such as mask, sensitive, secret, password, censored, redact, pii, and sens. (#202608111430)

Bugfixes

• Dependency upgrade: upload-sarif-7d9249f5a57288b8a472ddd9cc3ece1921f7dc38 (#20260807125603)

Misc

• #202608111330

"1.169.0" (2026-08-07)

Features

• ✨ [validation] Added when-rule helpers for not-equals, empty, and not-empty checks across property- and field-based validation. (#202608062230)
• ✨ [validation] Added non-recursive value-oriented helpers such as WhenFieldEqualsValue, RequiredFieldsBy, FieldDependencyBy, MutuallyExclusiveFieldsBy, and ForbiddenFieldsBy for clearer cross-field validation. (#202608070910)
• ✨ [validation] Added value-oriented field helpers because property-oriented rules are clearer for maps than structs, and struct Validate() implementations needed readable cross-field validation without recursive helper composition traps. (#202608071000)
• ✨ [validation] Add state-oriented validation rules for zero, emptiness, nil, and legacy required semantics, including a struct-friendly IsRequired that preserves pre-v4.4 ozzo behaviour. (#202608071215)
• 🐛 [validation] Replace safe library uses of raw ozzo validation.Required with the shared state-oriented utils/validation.Required, while keeping intentional non-empty or non-zero cases on ozzo or legacy semantics so zero-valued but present fields are validated consistently. (#202608071730)

Bugfixes

• 🐛 [jsonschema] Default schema options now keep filesystem.NoLimits() while schema validation only requires non-nil limits, so no-limit schemas no longer fail with missing Limits. (#202608062145)
• 🐛 [validation] Added regression coverage pinning the current validation.Required behaviour for zero-valued structs so future ozzo upgrades do not silently change repository validation semantics. (#202608071140)
• 🐛 [validation] Added a state-style Required rule to avoid OpenAPI validation issues where valid zero values such as false and numeric zero were incorrectly excluded, while still rejecting nil values, empty strings, and zero time.Time{}. See utils/validation/state_rules.go for the Required definition. (#202608071235)
• Dependency upgrade: upload-sarif-c1e7c7a0de342c642bc11d2219ba7a3cb2281f19 (#20260707160538)
• Dependency upgrade: timberjack-1.4.6 (#20260804101310)
• Dependency upgrade: v4-4.26.7 (#20260804101341)
• Dependency upgrade: upload-sarif-6a90bf1f5426d0c367cad0b2000f3b721bab3122 (#20260805101538)
• Dependency upgrade: v6-6.0.3 (#20260806101347)
• Dependency upgrade: codeql-action-4.37.5 (#20260806101652)
• Dependency upgrade: v5-5.5.1 (#20260807101334)
• Dependency upgrade: spdx-0.3.0 (#20260807101355)

"1.168.1" (2026-08-04)

Bugfixes

• ♻️ [validation] Time validation now supports optional time.Duration and time.Time pointers consistently, accepts RFC3339 timestamp strings and optional string pointers, and adds a NilTimestampOrNotEmpty helper for optional timestamp fields. (#202607251610)
• Dependency upgrade: codeql-action-4.37.4 (#20260730101302)
• Dependency upgrade: v5-5.5.0 (#20260730101326)
• Dependency upgrade: spdx-0.2.0 (#20260803101237)

"1.168.0" (2026-07-24)

Features

• ✨ [Logs/annotations] add structured CI annotation loggers for GitHub, Azure DevOps, and TeamCity, with adapters for logs.Loggers. (#202607161700)

Bugfixes

• Dependency upgrade: scorecard-action-2.4.4 (#20260724101455)

"1.167.0" (2026-07-23)

Features

• ✨ [Logs/summary] add in-memory and file-backed summary loggers, including GitHub summary support. (#202607161620)
• ✨ [reflection] add helpers for safe reflected property lookup across structs and maps, including JSON-tag-aware field resolution. (#202607161731)
• ✨ [validation] Added JSON-Schema-oriented validation helpers for numbers, strings, arrays, objects, combinators, and property relationships. See https://json-schema.org/understanding-json-schema/. (#20260608114500)
• ✨ [parallelisation] add MapConcurrent, MapConcurrentRef, and MapConcurrentSequence helpers. (#20260707123000)
• Logs: add the logs/summary package with summary loggers and GitHub Actions job summary support. (#20260707143000)

Bugfixes

• 🐛 [validation] Fixed NewNoneRule so it now correctly fails when any nested rule succeeds. (#20260608114600)
• Dependency upgrade: setup-go-7 (#20260716124746)
• Dependency upgrade: codeql-action-4.37.1 (#20260717101309)
• Dependency upgrade: setup-python-7 (#20260720101212)
• Dependency upgrade: logr-1.4.4 (#20260721101310)
• Dependency upgrade: codeql-action-4.37.3 (#20260722101436)

"1.166.1" (2026-07-16)

Bugfixes

• 🐛 [casing] fix regression in acronym-aware casing so normal PascalCase names like NoKeyring do not become NOKeyring (#20260716125731)

"1.166.0" (2026-07-16)

Features

• ✨ [URL] add configurable URL canonicalisation and comparison helpers for normalised matching. (#202607161530)

"1.165.2" (2026-07-15)

Bugfixes

• 🐛 Strings/casing: recognise the codebase's I... interface naming convention when handling acronym-prefixed identifiers such as IHTTP. (#20260707151500)
• 🐛 Strings/casing: improve plural initialism handling so identifiers such as Urls can be normalised to URLs where appropriate. (#20260707151600)
• Dependency upgrade: text-0.40.0 (#20260709101319)
• Dependency upgrade: codeql-action-4.37.0 (#20260709101326)
• Dependency upgrade: net-0.57.0 (#20260709101336)
• Dependency upgrade: crypto-0.54.0 (#20260709101342)
• Dependency upgrade: sync-0.22.0 (#20260709101404)
• Dependency upgrade: sys-0.47.0 (#20260714172504)

"1.165.1" (2026-07-08)

Bugfixes

• 🐛 [casing] fix toPascalCase regression (#20260708165859)

"1.165.0" (2026-07-08)

Features

• ✨ [Retry] add composable retry options with jitter, retry budget, etc. to ease the definition of retry strategies. (#20260707125500)

Bugfixes

• Dependency upgrade: codeql-action-4.36.3 (#20260702101311)
• Dependency upgrade: text-0.39.0 (#20260707101311)
• 🐛 [casing] fix casing helpers so adjacent acronym runs like AESRSA are preserved in existing camelCase and PascalCase identifiers instead of collapsing to Aesrsa. (#20260708153417)

"1.164.1" (2026-07-01)

Bugfixes

• 🐛 [jsonschema] Added support for ignoring YAML alias and anchor helper fields during schema validation when explicitly requested. (#20260608112000)
• Dependency upgrade: crypto-0.53.0 (#20260609101342)
• Dependency upgrade: checkout-7 (#20260619101252)
• Dependency upgrade: cache-6 (#20260624101305)
• Dependency upgrade: upload-sarif-9cea5827c668a1fe7165dbce6e80c3f9cf3f83ac (#20260626101420)
• Dependency upgrade: v4-4.9.0 (#20260629101306)
• Dependency upgrade: v4-4.26.6 (#20260701101231)
• Dependency upgrade: upload-sarif-628fc3f124e68b0151f0d2a5d81e864ee1e42335 (#20260701101351)

"1.164.0" (2026-06-18)

Features

• ✨ [collection] Added function composition helpers including Combine, CombineRef, CombineWithError, and CombineRefWithError for composing mapping functions right-to-left. (#20260608105500)
• ✨ [collection] Added coalescing and merging helpers including Coalesce, CoalesceRef, MergeBy, and MergeByRef for compacting adjacent values and merging grouped values. (#20260608105600)

Bugfixes

• Dependency upgrade: mongo-driver-1.17.7 (#20260618154523)
• 🐛 [casing] fix the merging o...

Release 1.170.1

Changelog

This document contains a history of significant changes which have been released for golang-utils. Please note that
beta releases are not included in this history.

"1.170.1" (2026-08-12)

Bugfixes

• ♻️ [value] Fix a regression introduced by switching flatten-map string conversion to StringConverter by restoring flatten-map scalar formatting, keeping fmt.Stringer and encoding.TextMarshaler precedence, wrapping text-marshalling failures as commonerrors.ErrMarshalling, and documenting pointer and struct fallback output. (#202608121215)
• Dependency upgrade: upload-sarif-c16c0f3f2812ec4bb3750a5ed64873fe2ce0fbef (#20260812101700)

"1.170.0" (2026-08-11)

Features

• ✨ [value] Added context-aware value converters, including IdentityConverter and StringConverter with fmt.Stringer, encoding.TextMarshaler, and fallback string formatting support. (#202608111300)
• ✨ [reflection] Added NewValueTypeConverter to adapt reflection-based converters into the shared value-converter interface. (#202608111301)
• ✨ [config] Added context-aware default-value converters for environment variable generation, including SecretConverter for masking sensitive values. (#202608111302)
• ✨ [reflection] Added helpers to detect field tag values on structs, struct pointers, and collection values containing tagged struct items. (#202608111345)
• 🔒 [config] Added tag-aware configuration masking converters that can automatically obfuscate sensitive values based on common field tags such as mask, sensitive, secret, password, censored, redact, pii, and sens. (#202608111430)

Bugfixes

• Dependency upgrade: upload-sarif-7d9249f5a57288b8a472ddd9cc3ece1921f7dc38 (#20260807125603)

Misc

• #202608111330

"1.169.0" (2026-08-07)

Features

• ✨ [validation] Added when-rule helpers for not-equals, empty, and not-empty checks across property- and field-based validation. (#202608062230)
• ✨ [validation] Added non-recursive value-oriented helpers such as WhenFieldEqualsValue, RequiredFieldsBy, FieldDependencyBy, MutuallyExclusiveFieldsBy, and ForbiddenFieldsBy for clearer cross-field validation. (#202608070910)
• ✨ [validation] Added value-oriented field helpers because property-oriented rules are clearer for maps than structs, and struct Validate() implementations needed readable cross-field validation without recursive helper composition traps. (#202608071000)
• ✨ [validation] Add state-oriented validation rules for zero, emptiness, nil, and legacy required semantics, including a struct-friendly IsRequired that preserves pre-v4.4 ozzo behaviour. (#202608071215)
• 🐛 [validation] Replace safe library uses of raw ozzo validation.Required with the shared state-oriented utils/validation.Required, while keeping intentional non-empty or non-zero cases on ozzo or legacy semantics so zero-valued but present fields are validated consistently. (#202608071730)

Bugfixes

• 🐛 [jsonschema] Default schema options now keep filesystem.NoLimits() while schema validation only requires non-nil limits, so no-limit schemas no longer fail with missing Limits. (#202608062145)
• 🐛 [validation] Added regression coverage pinning the current validation.Required behaviour for zero-valued structs so future ozzo upgrades do not silently change repository validation semantics. (#202608071140)
• 🐛 [validation] Added a state-style Required rule to avoid OpenAPI validation issues where valid zero values such as false and numeric zero were incorrectly excluded, while still rejecting nil values, empty strings, and zero time.Time{}. See utils/validation/state_rules.go for the Required definition. (#202608071235)
• Dependency upgrade: upload-sarif-c1e7c7a0de342c642bc11d2219ba7a3cb2281f19 (#20260707160538)
• Dependency upgrade: timberjack-1.4.6 (#20260804101310)
• Dependency upgrade: v4-4.26.7 (#20260804101341)
• Dependency upgrade: upload-sarif-6a90bf1f5426d0c367cad0b2000f3b721bab3122 (#20260805101538)
• Dependency upgrade: v6-6.0.3 (#20260806101347)
• Dependency upgrade: codeql-action-4.37.5 (#20260806101652)
• Dependency upgrade: v5-5.5.1 (#20260807101334)
• Dependency upgrade: spdx-0.3.0 (#20260807101355)

"1.168.1" (2026-08-04)

Bugfixes

• ♻️ [validation] Time validation now supports optional time.Duration and time.Time pointers consistently, accepts RFC3339 timestamp strings and optional string pointers, and adds a NilTimestampOrNotEmpty helper for optional timestamp fields. (#202607251610)
• Dependency upgrade: codeql-action-4.37.4 (#20260730101302)
• Dependency upgrade: v5-5.5.0 (#20260730101326)
• Dependency upgrade: spdx-0.2.0 (#20260803101237)

"1.168.0" (2026-07-24)

Features

• ✨ [Logs/annotations] add structured CI annotation loggers for GitHub, Azure DevOps, and TeamCity, with adapters for logs.Loggers. (#202607161700)

Bugfixes

• Dependency upgrade: scorecard-action-2.4.4 (#20260724101455)

"1.167.0" (2026-07-23)

Features

• ✨ [Logs/summary] add in-memory and file-backed summary loggers, including GitHub summary support. (#202607161620)
• ✨ [reflection] add helpers for safe reflected property lookup across structs and maps, including JSON-tag-aware field resolution. (#202607161731)
• ✨ [validation] Added JSON-Schema-oriented validation helpers for numbers, strings, arrays, objects, combinators, and property relationships. See https://json-schema.org/understanding-json-schema/. (#20260608114500)
• ✨ [parallelisation] add MapConcurrent, MapConcurrentRef, and MapConcurrentSequence helpers. (#20260707123000)
• Logs: add the logs/summary package with summary loggers and GitHub Actions job summary support. (#20260707143000)

Bugfixes

• 🐛 [validation] Fixed NewNoneRule so it now correctly fails when any nested rule succeeds. (#20260608114600)
• Dependency upgrade: setup-go-7 (#20260716124746)
• Dependency upgrade: codeql-action-4.37.1 (#20260717101309)
• Dependency upgrade: setup-python-7 (#20260720101212)
• Dependency upgrade: logr-1.4.4 (#20260721101310)
• Dependency upgrade: codeql-action-4.37.3 (#20260722101436)

"1.166.1" (2026-07-16)

Bugfixes

• 🐛 [casing] fix regression in acronym-aware casing so normal PascalCase names like NoKeyring do not become NOKeyring (#20260716125731)

"1.166.0" (2026-07-16)

Features

• ✨ [URL] add configurable URL canonicalisation and comparison helpers for normalised matching. (#202607161530)

"1.165.2" (2026-07-15)

Bugfixes

• 🐛 Strings/casing: recognise the codebase's I... interface naming convention when handling acronym-prefixed identifiers such as IHTTP. (#20260707151500)
• 🐛 Strings/casing: improve plural initialism handling so identifiers such as Urls can be normalised to URLs where appropriate. (#20260707151600)
• Dependency upgrade: text-0.40.0 (#20260709101319)
• Dependency upgrade: codeql-action-4.37.0 (#20260709101326)
• Dependency upgrade: net-0.57.0 (#20260709101336)
• Dependency upgrade: crypto-0.54.0 (#20260709101342)
• Dependency upgrade: sync-0.22.0 (#20260709101404)
• Dependency upgrade: sys-0.47.0 (#20260714172504)

"1.165.1" (2026-07-08)

Bugfixes

• 🐛 [casing] fix toPascalCase regression (#20260708165859)

"1.165.0" (2026-07-08)

Features

• ✨ [Retry] add composable retry options with jitter, retry budget, etc. to ease the definition of retry strategies. (#20260707125500)

Bugfixes

• Dependency upgrade: codeql-action-4.36.3 (#20260702101311)
• Dependency upgrade: text-0.39.0 (#20260707101311)
• 🐛 [casing] fix casing helpers so adjacent acronym runs like AESRSA are preserved in existing camelCase and PascalCase identifiers instead of collapsing to Aesrsa. (#20260708153417)

"1.164.1" (2026-07-01)

Bugfixes

• 🐛 [jsonschema] Added support for ignoring YAML alias and anchor helper fields during schema validation when explicitly requested. (#20260608112000)
• Dependency upgrade: crypto-0.53.0 (#20260609101342)
• Dependency upgrade: checkout-7 (#20260619101252)
• Dependency upgrade: cache-6 (#20260624101305)
• Dependency upgrade: upload-sarif-9cea5827c668a1fe7165dbce6e80c3f9cf3f83ac (#20260626101420)
• Dependency upgrade: v4-4.9.0 (#20260629101306)
• Dependency upgrade: v4-4.26.6 (#20260701101231)
• Dependency upgrade: upload-sarif-628fc3f124e68b0151f0d2a5d81e864ee1e42335 (#20260701101351)

"1.164.0" (2026-06-18)

Features

• ✨ [collection] Added function composition helpers including Combine, CombineRef, CombineWithError, and CombineRefWithError for composing mapping functions right-to-left. (#20260608105500)
• ✨ [collection] Added coalescing and merging helpers including Coalesce, CoalesceRef, MergeBy, and MergeByRef for compacting adjacent values and merging grouped values. (#20260608105600)

Bugfixes

• Dependency upgrade: mongo-driver-1.17.7 (#20260618154523)
• 🐛 [casing] fix the merging of rules rather than silently picking the latest defined (#20260618171355)

"1.163.0" (2026-06-18)

Features

• ✨ Added a package to change string casing but handling [go initialisms](htt...

Release 1.170.0

Changelog

This document contains a history of significant changes which have been released for golang-utils. Please note that
beta releases are not included in this history.

"1.170.0" (2026-08-11)

Features

• ✨ [value] Added context-aware value converters, including IdentityConverter and StringConverter with fmt.Stringer, encoding.TextMarshaler, and fallback string formatting support. (#202608111300)
• ✨ [reflection] Added NewValueTypeConverter to adapt reflection-based converters into the shared value-converter interface. (#202608111301)
• ✨ [config] Added context-aware default-value converters for environment variable generation, including SecretConverter for masking sensitive values. (#202608111302)
• ✨ [reflection] Added helpers to detect field tag values on structs, struct pointers, and collection values containing tagged struct items. (#202608111345)
• 🔒 [config] Added tag-aware configuration masking converters that can automatically obfuscate sensitive values based on common field tags such as mask, sensitive, secret, password, censored, redact, pii, and sens. (#202608111430)

Bugfixes

• Dependency upgrade: upload-sarif-7d9249f5a57288b8a472ddd9cc3ece1921f7dc38 (#20260807125603)

Misc

• #202608111330

"1.169.0" (2026-08-07)

Features

• ✨ [validation] Added when-rule helpers for not-equals, empty, and not-empty checks across property- and field-based validation. (#202608062230)
• ✨ [validation] Added non-recursive value-oriented helpers such as WhenFieldEqualsValue, RequiredFieldsBy, FieldDependencyBy, MutuallyExclusiveFieldsBy, and ForbiddenFieldsBy for clearer cross-field validation. (#202608070910)
• ✨ [validation] Added value-oriented field helpers because property-oriented rules are clearer for maps than structs, and struct Validate() implementations needed readable cross-field validation without recursive helper composition traps. (#202608071000)
• ✨ [validation] Add state-oriented validation rules for zero, emptiness, nil, and legacy required semantics, including a struct-friendly IsRequired that preserves pre-v4.4 ozzo behaviour. (#202608071215)
• 🐛 [validation] Replace safe library uses of raw ozzo validation.Required with the shared state-oriented utils/validation.Required, while keeping intentional non-empty or non-zero cases on ozzo or legacy semantics so zero-valued but present fields are validated consistently. (#202608071730)

Bugfixes

• 🐛 [jsonschema] Default schema options now keep filesystem.NoLimits() while schema validation only requires non-nil limits, so no-limit schemas no longer fail with missing Limits. (#202608062145)
• 🐛 [validation] Added regression coverage pinning the current validation.Required behaviour for zero-valued structs so future ozzo upgrades do not silently change repository validation semantics. (#202608071140)
• 🐛 [validation] Added a state-style Required rule to avoid OpenAPI validation issues where valid zero values such as false and numeric zero were incorrectly excluded, while still rejecting nil values, empty strings, and zero time.Time{}. See utils/validation/state_rules.go for the Required definition. (#202608071235)
• Dependency upgrade: upload-sarif-c1e7c7a0de342c642bc11d2219ba7a3cb2281f19 (#20260707160538)
• Dependency upgrade: timberjack-1.4.6 (#20260804101310)
• Dependency upgrade: v4-4.26.7 (#20260804101341)
• Dependency upgrade: upload-sarif-6a90bf1f5426d0c367cad0b2000f3b721bab3122 (#20260805101538)
• Dependency upgrade: v6-6.0.3 (#20260806101347)
• Dependency upgrade: codeql-action-4.37.5 (#20260806101652)
• Dependency upgrade: v5-5.5.1 (#20260807101334)
• Dependency upgrade: spdx-0.3.0 (#20260807101355)

"1.168.1" (2026-08-04)

Bugfixes

• ♻️ [validation] Time validation now supports optional time.Duration and time.Time pointers consistently, accepts RFC3339 timestamp strings and optional string pointers, and adds a NilTimestampOrNotEmpty helper for optional timestamp fields. (#202607251610)
• Dependency upgrade: codeql-action-4.37.4 (#20260730101302)
• Dependency upgrade: v5-5.5.0 (#20260730101326)
• Dependency upgrade: spdx-0.2.0 (#20260803101237)

"1.168.0" (2026-07-24)

Features

• ✨ [Logs/annotations] add structured CI annotation loggers for GitHub, Azure DevOps, and TeamCity, with adapters for logs.Loggers. (#202607161700)

Bugfixes

• Dependency upgrade: scorecard-action-2.4.4 (#20260724101455)

"1.167.0" (2026-07-23)

Features

• ✨ [Logs/summary] add in-memory and file-backed summary loggers, including GitHub summary support. (#202607161620)
• ✨ [reflection] add helpers for safe reflected property lookup across structs and maps, including JSON-tag-aware field resolution. (#202607161731)
• ✨ [validation] Added JSON-Schema-oriented validation helpers for numbers, strings, arrays, objects, combinators, and property relationships. See https://json-schema.org/understanding-json-schema/. (#20260608114500)
• ✨ [parallelisation] add MapConcurrent, MapConcurrentRef, and MapConcurrentSequence helpers. (#20260707123000)
• Logs: add the logs/summary package with summary loggers and GitHub Actions job summary support. (#20260707143000)

Bugfixes

• 🐛 [validation] Fixed NewNoneRule so it now correctly fails when any nested rule succeeds. (#20260608114600)
• Dependency upgrade: setup-go-7 (#20260716124746)
• Dependency upgrade: codeql-action-4.37.1 (#20260717101309)
• Dependency upgrade: setup-python-7 (#20260720101212)
• Dependency upgrade: logr-1.4.4 (#20260721101310)
• Dependency upgrade: codeql-action-4.37.3 (#20260722101436)

"1.166.1" (2026-07-16)

Bugfixes

• 🐛 [casing] fix regression in acronym-aware casing so normal PascalCase names like NoKeyring do not become NOKeyring (#20260716125731)

"1.166.0" (2026-07-16)

Features

• ✨ [URL] add configurable URL canonicalisation and comparison helpers for normalised matching. (#202607161530)

"1.165.2" (2026-07-15)

Bugfixes

• 🐛 Strings/casing: recognise the codebase's I... interface naming convention when handling acronym-prefixed identifiers such as IHTTP. (#20260707151500)
• 🐛 Strings/casing: improve plural initialism handling so identifiers such as Urls can be normalised to URLs where appropriate. (#20260707151600)
• Dependency upgrade: text-0.40.0 (#20260709101319)
• Dependency upgrade: codeql-action-4.37.0 (#20260709101326)
• Dependency upgrade: net-0.57.0 (#20260709101336)
• Dependency upgrade: crypto-0.54.0 (#20260709101342)
• Dependency upgrade: sync-0.22.0 (#20260709101404)
• Dependency upgrade: sys-0.47.0 (#20260714172504)

"1.165.1" (2026-07-08)

Bugfixes

• 🐛 [casing] fix toPascalCase regression (#20260708165859)

"1.165.0" (2026-07-08)

Features

• ✨ [Retry] add composable retry options with jitter, retry budget, etc. to ease the definition of retry strategies. (#20260707125500)

Bugfixes

• Dependency upgrade: codeql-action-4.36.3 (#20260702101311)
• Dependency upgrade: text-0.39.0 (#20260707101311)
• 🐛 [casing] fix casing helpers so adjacent acronym runs like AESRSA are preserved in existing camelCase and PascalCase identifiers instead of collapsing to Aesrsa. (#20260708153417)

"1.164.1" (2026-07-01)

Bugfixes

• 🐛 [jsonschema] Added support for ignoring YAML alias and anchor helper fields during schema validation when explicitly requested. (#20260608112000)
• Dependency upgrade: crypto-0.53.0 (#20260609101342)
• Dependency upgrade: checkout-7 (#20260619101252)
• Dependency upgrade: cache-6 (#20260624101305)
• Dependency upgrade: upload-sarif-9cea5827c668a1fe7165dbce6e80c3f9cf3f83ac (#20260626101420)
• Dependency upgrade: v4-4.9.0 (#20260629101306)
• Dependency upgrade: v4-4.26.6 (#20260701101231)
• Dependency upgrade: upload-sarif-628fc3f124e68b0151f0d2a5d81e864ee1e42335 (#20260701101351)

"1.164.0" (2026-06-18)

Features

• ✨ [collection] Added function composition helpers including Combine, CombineRef, CombineWithError, and CombineRefWithError for composing mapping functions right-to-left. (#20260608105500)
• ✨ [collection] Added coalescing and merging helpers including Coalesce, CoalesceRef, MergeBy, and MergeByRef for compacting adjacent values and merging grouped values. (#20260608105600)

Bugfixes

• Dependency upgrade: mongo-driver-1.17.7 (#20260618154523)
• 🐛 [casing] fix the merging of rules rather than silently picking the latest defined (#20260618171355)

"1.163.0" (2026-06-18)

Features

• ✨ Added a package to change string casing but handling go initialisms (#20260608105000)

Bugfixes

• 🐛 [frontmatter] Ensure that if a file starts with a byte-order mark that it is still parsable (#20260601172808)

"1.162.0" (2026-06-16)

Features

• ✨ [collection] Add helpers such as First... Last... (#20260610004910)

Bugfixes

• Dependency upgrade: net-0.56.0 (#20260611101315)
• Dependency upgrade: v4-4.8.0 (#20260615101359)

"1.161.2" (2026-06-09)
============...

Release 1.169.0

Changelog

This document contains a history of significant changes which have been released for golang-utils. Please note that
beta releases are not included in this history.

"1.169.0" (2026-08-07)

Features

• ✨ [validation] Added when-rule helpers for not-equals, empty, and not-empty checks across property- and field-based validation. (#202608062230)
• ✨ [validation] Added non-recursive value-oriented helpers such as WhenFieldEqualsValue, RequiredFieldsBy, FieldDependencyBy, MutuallyExclusiveFieldsBy, and ForbiddenFieldsBy for clearer cross-field validation. (#202608070910)
• ✨ [validation] Added value-oriented field helpers because property-oriented rules are clearer for maps than structs, and struct Validate() implementations needed readable cross-field validation without recursive helper composition traps. (#202608071000)
• ✨ [validation] Add state-oriented validation rules for zero, emptiness, nil, and legacy required semantics, including a struct-friendly IsRequired that preserves pre-v4.4 ozzo behaviour. (#202608071215)
• 🐛 [validation] Replace safe library uses of raw ozzo validation.Required with the shared state-oriented utils/validation.Required, while keeping intentional non-empty or non-zero cases on ozzo or legacy semantics so zero-valued but present fields are validated consistently. (#202608071730)

Bugfixes

• 🐛 [jsonschema] Default schema options now keep filesystem.NoLimits() while schema validation only requires non-nil limits, so no-limit schemas no longer fail with missing Limits. (#202608062145)
• 🐛 [validation] Added regression coverage pinning the current validation.Required behaviour for zero-valued structs so future ozzo upgrades do not silently change repository validation semantics. (#202608071140)
• 🐛 [validation] Added a state-style Required rule to avoid OpenAPI validation issues where valid zero values such as false and numeric zero were incorrectly excluded, while still rejecting nil values, empty strings, and zero time.Time{}. See utils/validation/state_rules.go for the Required definition. (#202608071235)
• Dependency upgrade: upload-sarif-c1e7c7a0de342c642bc11d2219ba7a3cb2281f19 (#20260707160538)
• Dependency upgrade: timberjack-1.4.6 (#20260804101310)
• Dependency upgrade: v4-4.26.7 (#20260804101341)
• Dependency upgrade: upload-sarif-6a90bf1f5426d0c367cad0b2000f3b721bab3122 (#20260805101538)
• Dependency upgrade: v6-6.0.3 (#20260806101347)
• Dependency upgrade: codeql-action-4.37.5 (#20260806101652)
• Dependency upgrade: v5-5.5.1 (#20260807101334)
• Dependency upgrade: spdx-0.3.0 (#20260807101355)

"1.168.1" (2026-08-04)

Bugfixes

• ♻️ [validation] Time validation now supports optional time.Duration and time.Time pointers consistently, accepts RFC3339 timestamp strings and optional string pointers, and adds a NilTimestampOrNotEmpty helper for optional timestamp fields. (#202607251610)
• Dependency upgrade: codeql-action-4.37.4 (#20260730101302)
• Dependency upgrade: v5-5.5.0 (#20260730101326)
• Dependency upgrade: spdx-0.2.0 (#20260803101237)

"1.168.0" (2026-07-24)

Features

• ✨ [Logs/annotations] add structured CI annotation loggers for GitHub, Azure DevOps, and TeamCity, with adapters for logs.Loggers. (#202607161700)

Bugfixes

• Dependency upgrade: scorecard-action-2.4.4 (#20260724101455)

"1.167.0" (2026-07-23)

Features

• ✨ [Logs/summary] add in-memory and file-backed summary loggers, including GitHub summary support. (#202607161620)
• ✨ [reflection] add helpers for safe reflected property lookup across structs and maps, including JSON-tag-aware field resolution. (#202607161731)
• ✨ [validation] Added JSON-Schema-oriented validation helpers for numbers, strings, arrays, objects, combinators, and property relationships. See https://json-schema.org/understanding-json-schema/. (#20260608114500)
• ✨ [parallelisation] add MapConcurrent, MapConcurrentRef, and MapConcurrentSequence helpers. (#20260707123000)
• Logs: add the logs/summary package with summary loggers and GitHub Actions job summary support. (#20260707143000)

Bugfixes

• 🐛 [validation] Fixed NewNoneRule so it now correctly fails when any nested rule succeeds. (#20260608114600)
• Dependency upgrade: setup-go-7 (#20260716124746)
• Dependency upgrade: codeql-action-4.37.1 (#20260717101309)
• Dependency upgrade: setup-python-7 (#20260720101212)
• Dependency upgrade: logr-1.4.4 (#20260721101310)
• Dependency upgrade: codeql-action-4.37.3 (#20260722101436)

"1.166.1" (2026-07-16)

Bugfixes

• 🐛 [casing] fix regression in acronym-aware casing so normal PascalCase names like NoKeyring do not become NOKeyring (#20260716125731)

"1.166.0" (2026-07-16)

Features

• ✨ [URL] add configurable URL canonicalisation and comparison helpers for normalised matching. (#202607161530)

"1.165.2" (2026-07-15)

Bugfixes

• 🐛 Strings/casing: recognise the codebase's I... interface naming convention when handling acronym-prefixed identifiers such as IHTTP. (#20260707151500)
• 🐛 Strings/casing: improve plural initialism handling so identifiers such as Urls can be normalised to URLs where appropriate. (#20260707151600)
• Dependency upgrade: text-0.40.0 (#20260709101319)
• Dependency upgrade: codeql-action-4.37.0 (#20260709101326)
• Dependency upgrade: net-0.57.0 (#20260709101336)
• Dependency upgrade: crypto-0.54.0 (#20260709101342)
• Dependency upgrade: sync-0.22.0 (#20260709101404)
• Dependency upgrade: sys-0.47.0 (#20260714172504)

"1.165.1" (2026-07-08)

Bugfixes

• 🐛 [casing] fix toPascalCase regression (#20260708165859)

"1.165.0" (2026-07-08)

Features

• ✨ [Retry] add composable retry options with jitter, retry budget, etc. to ease the definition of retry strategies. (#20260707125500)

Bugfixes

• Dependency upgrade: codeql-action-4.36.3 (#20260702101311)
• Dependency upgrade: text-0.39.0 (#20260707101311)
• 🐛 [casing] fix casing helpers so adjacent acronym runs like AESRSA are preserved in existing camelCase and PascalCase identifiers instead of collapsing to Aesrsa. (#20260708153417)

"1.164.1" (2026-07-01)

Bugfixes

• 🐛 [jsonschema] Added support for ignoring YAML alias and anchor helper fields during schema validation when explicitly requested. (#20260608112000)
• Dependency upgrade: crypto-0.53.0 (#20260609101342)
• Dependency upgrade: checkout-7 (#20260619101252)
• Dependency upgrade: cache-6 (#20260624101305)
• Dependency upgrade: upload-sarif-9cea5827c668a1fe7165dbce6e80c3f9cf3f83ac (#20260626101420)
• Dependency upgrade: v4-4.9.0 (#20260629101306)
• Dependency upgrade: v4-4.26.6 (#20260701101231)
• Dependency upgrade: upload-sarif-628fc3f124e68b0151f0d2a5d81e864ee1e42335 (#20260701101351)

"1.164.0" (2026-06-18)

Features

• ✨ [collection] Added function composition helpers including Combine, CombineRef, CombineWithError, and CombineRefWithError for composing mapping functions right-to-left. (#20260608105500)
• ✨ [collection] Added coalescing and merging helpers including Coalesce, CoalesceRef, MergeBy, and MergeByRef for compacting adjacent values and merging grouped values. (#20260608105600)

Bugfixes

• Dependency upgrade: mongo-driver-1.17.7 (#20260618154523)
• 🐛 [casing] fix the merging of rules rather than silently picking the latest defined (#20260618171355)

"1.163.0" (2026-06-18)

Features

• ✨ Added a package to change string casing but handling go initialisms (#20260608105000)

Bugfixes

• 🐛 [frontmatter] Ensure that if a file starts with a byte-order mark that it is still parsable (#20260601172808)

"1.162.0" (2026-06-16)

Features

• ✨ [collection] Add helpers such as First... Last... (#20260610004910)

Bugfixes

• Dependency upgrade: net-0.56.0 (#20260611101315)
• Dependency upgrade: v4-4.8.0 (#20260615101359)

"1.161.2" (2026-06-09)

Bugfixes

• Dependency upgrade: v4-4.26.5 (#20260603103438)
• Dependency upgrade: codeql-action-4.36.1 (#20260603235051)
• Dependency upgrade: codeql-action-4.36.2 (#20260605101427)
• Fixed collection sequence helpers so nil iter.Seq values no longer panic and instead behave like empty sequences. (#20260608103100)
• Dependency upgrade: sync-0.21.0 (#20260609101327)
• Dependency upgrade: text-0.38.0 (#20260609101338)
• Dependency upgrade: sys-0.46.0 (#20260609133240)

"1.161.1" (2026-06-03)

Bugfixes

• 🐛 [frontmatter] Ensure that different formats with the same start fence are treated as distinct formats (#20260602103158)

"1.161.0" (2026-06-02)

Features

• ✨ [reflection] Introduced a not empty helper (#20260601231830)
• ✨ [collection] Added additional helpers to ease operation on collection (#20260602001604)

Improved Documentation

• 📖 [collection] Improve documentation (#20260601232922)

"1.160.1" (2026-05-29)

Bugfixes

• Fixed filesystem removal on macOS when deleting directories using un...

Release 1.168.1

Changelog

This document contains a history of significant changes which have been released for golang-utils. Please note that
beta releases are not included in this history.

"1.168.1" (2026-08-04)

Bugfixes

• ♻️ [validation] Time validation now supports optional time.Duration and time.Time pointers consistently, accepts RFC3339 timestamp strings and optional string pointers, and adds a NilTimestampOrNotEmpty helper for optional timestamp fields. (#202607251610)
• Dependency upgrade: codeql-action-4.37.4 (#20260730101302)
• Dependency upgrade: v5-5.5.0 (#20260730101326)
• Dependency upgrade: spdx-0.2.0 (#20260803101237)

"1.168.0" (2026-07-24)

Features

• ✨ [Logs/annotations] add structured CI annotation loggers for GitHub, Azure DevOps, and TeamCity, with adapters for logs.Loggers. (#202607161700)

Bugfixes

• Dependency upgrade: scorecard-action-2.4.4 (#20260724101455)

"1.167.0" (2026-07-23)

Features

• ✨ [Logs/summary] add in-memory and file-backed summary loggers, including GitHub summary support. (#202607161620)
• ✨ [reflection] add helpers for safe reflected property lookup across structs and maps, including JSON-tag-aware field resolution. (#202607161731)
• ✨ [validation] Added JSON-Schema-oriented validation helpers for numbers, strings, arrays, objects, combinators, and property relationships. See https://json-schema.org/understanding-json-schema/. (#20260608114500)
• ✨ [parallelisation] add MapConcurrent, MapConcurrentRef, and MapConcurrentSequence helpers. (#20260707123000)
• Logs: add the logs/summary package with summary loggers and GitHub Actions job summary support. (#20260707143000)

Bugfixes

• 🐛 [validation] Fixed NewNoneRule so it now correctly fails when any nested rule succeeds. (#20260608114600)
• Dependency upgrade: setup-go-7 (#20260716124746)
• Dependency upgrade: codeql-action-4.37.1 (#20260717101309)
• Dependency upgrade: setup-python-7 (#20260720101212)
• Dependency upgrade: logr-1.4.4 (#20260721101310)
• Dependency upgrade: codeql-action-4.37.3 (#20260722101436)

"1.166.1" (2026-07-16)

Bugfixes

• 🐛 [casing] fix regression in acronym-aware casing so normal PascalCase names like NoKeyring do not become NOKeyring (#20260716125731)

"1.166.0" (2026-07-16)

Features

• ✨ [URL] add configurable URL canonicalisation and comparison helpers for normalised matching. (#202607161530)

"1.165.2" (2026-07-15)

Bugfixes

• 🐛 Strings/casing: recognise the codebase's I... interface naming convention when handling acronym-prefixed identifiers such as IHTTP. (#20260707151500)
• 🐛 Strings/casing: improve plural initialism handling so identifiers such as Urls can be normalised to URLs where appropriate. (#20260707151600)
• Dependency upgrade: text-0.40.0 (#20260709101319)
• Dependency upgrade: codeql-action-4.37.0 (#20260709101326)
• Dependency upgrade: net-0.57.0 (#20260709101336)
• Dependency upgrade: crypto-0.54.0 (#20260709101342)
• Dependency upgrade: sync-0.22.0 (#20260709101404)
• Dependency upgrade: sys-0.47.0 (#20260714172504)

"1.165.1" (2026-07-08)

Bugfixes

• 🐛 [casing] fix toPascalCase regression (#20260708165859)

"1.165.0" (2026-07-08)

Features

• ✨ [Retry] add composable retry options with jitter, retry budget, etc. to ease the definition of retry strategies. (#20260707125500)

Bugfixes

• Dependency upgrade: codeql-action-4.36.3 (#20260702101311)
• Dependency upgrade: text-0.39.0 (#20260707101311)
• 🐛 [casing] fix casing helpers so adjacent acronym runs like AESRSA are preserved in existing camelCase and PascalCase identifiers instead of collapsing to Aesrsa. (#20260708153417)

"1.164.1" (2026-07-01)

Bugfixes

• 🐛 [jsonschema] Added support for ignoring YAML alias and anchor helper fields during schema validation when explicitly requested. (#20260608112000)
• Dependency upgrade: crypto-0.53.0 (#20260609101342)
• Dependency upgrade: checkout-7 (#20260619101252)
• Dependency upgrade: cache-6 (#20260624101305)
• Dependency upgrade: upload-sarif-9cea5827c668a1fe7165dbce6e80c3f9cf3f83ac (#20260626101420)
• Dependency upgrade: v4-4.9.0 (#20260629101306)
• Dependency upgrade: v4-4.26.6 (#20260701101231)
• Dependency upgrade: upload-sarif-628fc3f124e68b0151f0d2a5d81e864ee1e42335 (#20260701101351)

"1.164.0" (2026-06-18)

Features

• ✨ [collection] Added function composition helpers including Combine, CombineRef, CombineWithError, and CombineRefWithError for composing mapping functions right-to-left. (#20260608105500)
• ✨ [collection] Added coalescing and merging helpers including Coalesce, CoalesceRef, MergeBy, and MergeByRef for compacting adjacent values and merging grouped values. (#20260608105600)

Bugfixes

• Dependency upgrade: mongo-driver-1.17.7 (#20260618154523)
• 🐛 [casing] fix the merging of rules rather than silently picking the latest defined (#20260618171355)

"1.163.0" (2026-06-18)

Features

• ✨ Added a package to change string casing but handling go initialisms (#20260608105000)

Bugfixes

• 🐛 [frontmatter] Ensure that if a file starts with a byte-order mark that it is still parsable (#20260601172808)

"1.162.0" (2026-06-16)

Features

• ✨ [collection] Add helpers such as First... Last... (#20260610004910)

Bugfixes

• Dependency upgrade: net-0.56.0 (#20260611101315)
• Dependency upgrade: v4-4.8.0 (#20260615101359)

"1.161.2" (2026-06-09)

Bugfixes

• Dependency upgrade: v4-4.26.5 (#20260603103438)
• Dependency upgrade: codeql-action-4.36.1 (#20260603235051)
• Dependency upgrade: codeql-action-4.36.2 (#20260605101427)
• Fixed collection sequence helpers so nil iter.Seq values no longer panic and instead behave like empty sequences. (#20260608103100)
• Dependency upgrade: sync-0.21.0 (#20260609101327)
• Dependency upgrade: text-0.38.0 (#20260609101338)
• Dependency upgrade: sys-0.46.0 (#20260609133240)

"1.161.1" (2026-06-03)

Bugfixes

• 🐛 [frontmatter] Ensure that different formats with the same start fence are treated as distinct formats (#20260602103158)

"1.161.0" (2026-06-02)

Features

• ✨ [reflection] Introduced a not empty helper (#20260601231830)
• ✨ [collection] Added additional helpers to ease operation on collection (#20260602001604)

Improved Documentation

• 📖 [collection] Improve documentation (#20260601232922)

"1.160.1" (2026-05-29)

Bugfixes

• Fixed filesystem removal on macOS when deleting directories using unlink. (#202605290935)

"1.160.0" (2026-05-28)

Features

• ✨ [serialization] added helpers from extracting front matters from documents (#20260527190231)

"1.159.0" (2026-05-27)

Features

• ✨ [yaml] Added helpers for checking valid files extensions (#20260527132139)
• ✨ [json] Added helpers for checking valid files extensions (#20260527132146)
• ⚙️ [jsonschema] Extend JSON Schema validation with schema options and support for schemas defined in YAML. (#20260527132214)

Bugfixes

• Dependency upgrade: easyjson-0.9.2 (#20260526175306)
• Dependency upgrade: timberjack-1.4.5 (#20260527121614)

"1.158.0" (2026-05-26)

Features

• ⚡ add helpers for supporting json marshalling with better performance than encoding/json (#20260521144643)
• ✨ add helpers for serialising yaml (#20260521162032)
• ✨ add helpers to validate files against a JSON schema in jsonschema (#20260521183044)
• ✨ [filesystem] Added validation rules for checking that a file path has the required extension (#20260521184825)

Bugfixes

• Dependency upgrade: codeql-action-4.35.4 (#20260515131752)
• Dependency upgrade: v5-5.19.1 (#20260519161135)
• Dependency upgrade: sys-0.45.0 (#20260522102515)
• Dependency upgrade: crypto-0.52.0 (#20260522102520)
• Dependency upgrade: net-0.55.0 (#20260522102524)
• Dependency upgrade: spdx-0.1.4 (#20260525155040)
• Dependency upgrade: codeql-action-4.36.0 (#20260525155205)

"1.157.1" (2026-05-11)

Bugfixes

• Dependency upgrade: sys-0.43.0 (#20260409101816)
• Dependency upgrade: crypto-0.50.0 (#20260410101244)
• Dependency upgrade: mod-0.35.0 (#20260410101259)
• Dependency upgrade: net-0.53.0 (#20260410101300)
• Dependency upgrade: upload-artifact-7.0.1 (#20260413110322)
• Dependency upgrade: codeql-action-4.35.2 (#20260416101503)
• Dependency upgrade: v5-5.18.0 (#20260417101349)
• Dependency upgrade: zerolog-1.35.1 (#20260421101451)
• Dependency upgrade: v2-2.9.0 (#20260421101500)
• Dependency upgrade: timberjack-1.4.2 (#20260421101514)
• Dependency upgrade: zap-1.28.0 (#20260428101825)
• Dependency upgrade: v4-4.26.4 (#20260501114549)
• Dependency upgrade: spdx-0.1.3 (#20260504122618)
• Dependency upgrade: crypto-0.51.0 (#20260511154537)
• Dependency upgrade: net-0.54.0 (#20260511154553)
• Dependency upgrade: v5-5.19.0 ...

Release 1.168.0

Changelog

This document contains a history of significant changes which have been released for golang-utils. Please note that
beta releases are not included in this history.

"1.168.0" (2026-07-24)

Features

• ✨ [Logs/annotations] add structured CI annotation loggers for GitHub, Azure DevOps, and TeamCity, with adapters for logs.Loggers. (#202607161700)

Bugfixes

• Dependency upgrade: scorecard-action-2.4.4 (#20260724101455)

"1.167.0" (2026-07-23)

Features

• ✨ [Logs/summary] add in-memory and file-backed summary loggers, including GitHub summary support. (#202607161620)
• ✨ [reflection] add helpers for safe reflected property lookup across structs and maps, including JSON-tag-aware field resolution. (#202607161731)
• ✨ [validation] Added JSON-Schema-oriented validation helpers for numbers, strings, arrays, objects, combinators, and property relationships. See https://json-schema.org/understanding-json-schema/. (#20260608114500)
• ✨ [parallelisation] add MapConcurrent, MapConcurrentRef, and MapConcurrentSequence helpers. (#20260707123000)
• Logs: add the logs/summary package with summary loggers and GitHub Actions job summary support. (#20260707143000)

Bugfixes

• 🐛 [validation] Fixed NewNoneRule so it now correctly fails when any nested rule succeeds. (#20260608114600)
• Dependency upgrade: setup-go-7 (#20260716124746)
• Dependency upgrade: codeql-action-4.37.1 (#20260717101309)
• Dependency upgrade: setup-python-7 (#20260720101212)
• Dependency upgrade: logr-1.4.4 (#20260721101310)
• Dependency upgrade: codeql-action-4.37.3 (#20260722101436)

"1.166.1" (2026-07-16)

Bugfixes

• 🐛 [casing] fix regression in acronym-aware casing so normal PascalCase names like NoKeyring do not become NOKeyring (#20260716125731)

"1.166.0" (2026-07-16)

Features

• ✨ [URL] add configurable URL canonicalisation and comparison helpers for normalised matching. (#202607161530)

"1.165.2" (2026-07-15)

Bugfixes

• 🐛 Strings/casing: recognise the codebase's I... interface naming convention when handling acronym-prefixed identifiers such as IHTTP. (#20260707151500)
• 🐛 Strings/casing: improve plural initialism handling so identifiers such as Urls can be normalised to URLs where appropriate. (#20260707151600)
• Dependency upgrade: text-0.40.0 (#20260709101319)
• Dependency upgrade: codeql-action-4.37.0 (#20260709101326)
• Dependency upgrade: net-0.57.0 (#20260709101336)
• Dependency upgrade: crypto-0.54.0 (#20260709101342)
• Dependency upgrade: sync-0.22.0 (#20260709101404)
• Dependency upgrade: sys-0.47.0 (#20260714172504)

"1.165.1" (2026-07-08)

Bugfixes

• 🐛 [casing] fix toPascalCase regression (#20260708165859)

"1.165.0" (2026-07-08)

Features

• ✨ [Retry] add composable retry options with jitter, retry budget, etc. to ease the definition of retry strategies. (#20260707125500)

Bugfixes

• Dependency upgrade: codeql-action-4.36.3 (#20260702101311)
• Dependency upgrade: text-0.39.0 (#20260707101311)
• 🐛 [casing] fix casing helpers so adjacent acronym runs like AESRSA are preserved in existing camelCase and PascalCase identifiers instead of collapsing to Aesrsa. (#20260708153417)

"1.164.1" (2026-07-01)

Bugfixes

• 🐛 [jsonschema] Added support for ignoring YAML alias and anchor helper fields during schema validation when explicitly requested. (#20260608112000)
• Dependency upgrade: crypto-0.53.0 (#20260609101342)
• Dependency upgrade: checkout-7 (#20260619101252)
• Dependency upgrade: cache-6 (#20260624101305)
• Dependency upgrade: upload-sarif-9cea5827c668a1fe7165dbce6e80c3f9cf3f83ac (#20260626101420)
• Dependency upgrade: v4-4.9.0 (#20260629101306)
• Dependency upgrade: v4-4.26.6 (#20260701101231)
• Dependency upgrade: upload-sarif-628fc3f124e68b0151f0d2a5d81e864ee1e42335 (#20260701101351)

"1.164.0" (2026-06-18)

Features

• ✨ [collection] Added function composition helpers including Combine, CombineRef, CombineWithError, and CombineRefWithError for composing mapping functions right-to-left. (#20260608105500)
• ✨ [collection] Added coalescing and merging helpers including Coalesce, CoalesceRef, MergeBy, and MergeByRef for compacting adjacent values and merging grouped values. (#20260608105600)

Bugfixes

• Dependency upgrade: mongo-driver-1.17.7 (#20260618154523)
• 🐛 [casing] fix the merging of rules rather than silently picking the latest defined (#20260618171355)

"1.163.0" (2026-06-18)

Features

• ✨ Added a package to change string casing but handling go initialisms (#20260608105000)

Bugfixes

• 🐛 [frontmatter] Ensure that if a file starts with a byte-order mark that it is still parsable (#20260601172808)

"1.162.0" (2026-06-16)

Features

• ✨ [collection] Add helpers such as First... Last... (#20260610004910)

Bugfixes

• Dependency upgrade: net-0.56.0 (#20260611101315)
• Dependency upgrade: v4-4.8.0 (#20260615101359)

"1.161.2" (2026-06-09)

Bugfixes

• Dependency upgrade: v4-4.26.5 (#20260603103438)
• Dependency upgrade: codeql-action-4.36.1 (#20260603235051)
• Dependency upgrade: codeql-action-4.36.2 (#20260605101427)
• Fixed collection sequence helpers so nil iter.Seq values no longer panic and instead behave like empty sequences. (#20260608103100)
• Dependency upgrade: sync-0.21.0 (#20260609101327)
• Dependency upgrade: text-0.38.0 (#20260609101338)
• Dependency upgrade: sys-0.46.0 (#20260609133240)

"1.161.1" (2026-06-03)

Bugfixes

• 🐛 [frontmatter] Ensure that different formats with the same start fence are treated as distinct formats (#20260602103158)

"1.161.0" (2026-06-02)

Features

• ✨ [reflection] Introduced a not empty helper (#20260601231830)
• ✨ [collection] Added additional helpers to ease operation on collection (#20260602001604)

Improved Documentation

• 📖 [collection] Improve documentation (#20260601232922)

"1.160.1" (2026-05-29)

Bugfixes

• Fixed filesystem removal on macOS when deleting directories using unlink. (#202605290935)

"1.160.0" (2026-05-28)

Features

• ✨ [serialization] added helpers from extracting front matters from documents (#20260527190231)

"1.159.0" (2026-05-27)

Features

• ✨ [yaml] Added helpers for checking valid files extensions (#20260527132139)
• ✨ [json] Added helpers for checking valid files extensions (#20260527132146)
• ⚙️ [jsonschema] Extend JSON Schema validation with schema options and support for schemas defined in YAML. (#20260527132214)

Bugfixes

• Dependency upgrade: easyjson-0.9.2 (#20260526175306)
• Dependency upgrade: timberjack-1.4.5 (#20260527121614)

"1.158.0" (2026-05-26)

Features

• ⚡ add helpers for supporting json marshalling with better performance than encoding/json (#20260521144643)
• ✨ add helpers for serialising yaml (#20260521162032)
• ✨ add helpers to validate files against a JSON schema in jsonschema (#20260521183044)
• ✨ [filesystem] Added validation rules for checking that a file path has the required extension (#20260521184825)

Bugfixes

• Dependency upgrade: codeql-action-4.35.4 (#20260515131752)
• Dependency upgrade: v5-5.19.1 (#20260519161135)
• Dependency upgrade: sys-0.45.0 (#20260522102515)
• Dependency upgrade: crypto-0.52.0 (#20260522102520)
• Dependency upgrade: net-0.55.0 (#20260522102524)
• Dependency upgrade: spdx-0.1.4 (#20260525155040)
• Dependency upgrade: codeql-action-4.36.0 (#20260525155205)

"1.157.1" (2026-05-11)

Bugfixes

• Dependency upgrade: sys-0.43.0 (#20260409101816)
• Dependency upgrade: crypto-0.50.0 (#20260410101244)
• Dependency upgrade: mod-0.35.0 (#20260410101259)
• Dependency upgrade: net-0.53.0 (#20260410101300)
• Dependency upgrade: upload-artifact-7.0.1 (#20260413110322)
• Dependency upgrade: codeql-action-4.35.2 (#20260416101503)
• Dependency upgrade: v5-5.18.0 (#20260417101349)
• Dependency upgrade: zerolog-1.35.1 (#20260421101451)
• Dependency upgrade: v2-2.9.0 (#20260421101500)
• Dependency upgrade: timberjack-1.4.2 (#20260421101514)
• Dependency upgrade: zap-1.28.0 (#20260428101825)
• Dependency upgrade: v4-4.26.4 (#20260501114549)
• Dependency upgrade: spdx-0.1.3 (#20260504122618)
• Dependency upgrade: crypto-0.51.0 (#20260511154537)
• Dependency upgrade: net-0.54.0 (#20260511154553)
• Dependency upgrade: v5-5.19.0 (#20260511163359)
• Dependency upgrade: fetch-metadata-3.1.0 (#20260511163423)

Misc

• #20260507133219

"1.157.0" (2026-04-22)

Features

• ✨ Add support for specifying the directory in subprocess commands (#20260422120133)

"1.156.1" (2026-04-07)

Bugfixes

• Dependency upgrade: timberjack-1.4.1 (#20260403101304)

Misc

• #20260407112643

"1.156.0" (2026-04-01)

Features

• :spa...

Release 1.167.0

Changelog

This document contains a history of significant changes which have been released for golang-utils. Please note that
beta releases are not included in this history.

"1.167.0" (2026-07-23)

Features

• ✨ [Logs/summary] add in-memory and file-backed summary loggers, including GitHub summary support. (#202607161620)
• ✨ [reflection] add helpers for safe reflected property lookup across structs and maps, including JSON-tag-aware field resolution. (#202607161731)
• ✨ [validation] Added JSON-Schema-oriented validation helpers for numbers, strings, arrays, objects, combinators, and property relationships. See https://json-schema.org/understanding-json-schema/. (#20260608114500)
• ✨ [parallelisation] add MapConcurrent, MapConcurrentRef, and MapConcurrentSequence helpers. (#20260707123000)
• Logs: add the logs/summary package with summary loggers and GitHub Actions job summary support. (#20260707143000)

Bugfixes

• 🐛 [validation] Fixed NewNoneRule so it now correctly fails when any nested rule succeeds. (#20260608114600)
• Dependency upgrade: setup-go-7 (#20260716124746)
• Dependency upgrade: codeql-action-4.37.1 (#20260717101309)
• Dependency upgrade: setup-python-7 (#20260720101212)
• Dependency upgrade: logr-1.4.4 (#20260721101310)
• Dependency upgrade: codeql-action-4.37.3 (#20260722101436)

"1.166.1" (2026-07-16)

Bugfixes

• 🐛 [casing] fix regression in acronym-aware casing so normal PascalCase names like NoKeyring do not become NOKeyring (#20260716125731)

"1.166.0" (2026-07-16)

Features

• ✨ [URL] add configurable URL canonicalisation and comparison helpers for normalised matching. (#202607161530)

"1.165.2" (2026-07-15)

Bugfixes

• 🐛 Strings/casing: recognise the codebase's I... interface naming convention when handling acronym-prefixed identifiers such as IHTTP. (#20260707151500)
• 🐛 Strings/casing: improve plural initialism handling so identifiers such as Urls can be normalised to URLs where appropriate. (#20260707151600)
• Dependency upgrade: text-0.40.0 (#20260709101319)
• Dependency upgrade: codeql-action-4.37.0 (#20260709101326)
• Dependency upgrade: net-0.57.0 (#20260709101336)
• Dependency upgrade: crypto-0.54.0 (#20260709101342)
• Dependency upgrade: sync-0.22.0 (#20260709101404)
• Dependency upgrade: sys-0.47.0 (#20260714172504)

"1.165.1" (2026-07-08)

Bugfixes

• 🐛 [casing] fix toPascalCase regression (#20260708165859)

"1.165.0" (2026-07-08)

Features

• ✨ [Retry] add composable retry options with jitter, retry budget, etc. to ease the definition of retry strategies. (#20260707125500)

Bugfixes

• Dependency upgrade: codeql-action-4.36.3 (#20260702101311)
• Dependency upgrade: text-0.39.0 (#20260707101311)
• 🐛 [casing] fix casing helpers so adjacent acronym runs like AESRSA are preserved in existing camelCase and PascalCase identifiers instead of collapsing to Aesrsa. (#20260708153417)

"1.164.1" (2026-07-01)

Bugfixes

• 🐛 [jsonschema] Added support for ignoring YAML alias and anchor helper fields during schema validation when explicitly requested. (#20260608112000)
• Dependency upgrade: crypto-0.53.0 (#20260609101342)
• Dependency upgrade: checkout-7 (#20260619101252)
• Dependency upgrade: cache-6 (#20260624101305)
• Dependency upgrade: upload-sarif-9cea5827c668a1fe7165dbce6e80c3f9cf3f83ac (#20260626101420)
• Dependency upgrade: v4-4.9.0 (#20260629101306)
• Dependency upgrade: v4-4.26.6 (#20260701101231)
• Dependency upgrade: upload-sarif-628fc3f124e68b0151f0d2a5d81e864ee1e42335 (#20260701101351)

"1.164.0" (2026-06-18)

Features

• ✨ [collection] Added function composition helpers including Combine, CombineRef, CombineWithError, and CombineRefWithError for composing mapping functions right-to-left. (#20260608105500)
• ✨ [collection] Added coalescing and merging helpers including Coalesce, CoalesceRef, MergeBy, and MergeByRef for compacting adjacent values and merging grouped values. (#20260608105600)

Bugfixes

• Dependency upgrade: mongo-driver-1.17.7 (#20260618154523)
• 🐛 [casing] fix the merging of rules rather than silently picking the latest defined (#20260618171355)

"1.163.0" (2026-06-18)

Features

• ✨ Added a package to change string casing but handling go initialisms (#20260608105000)

Bugfixes

• 🐛 [frontmatter] Ensure that if a file starts with a byte-order mark that it is still parsable (#20260601172808)

"1.162.0" (2026-06-16)

Features

• ✨ [collection] Add helpers such as First... Last... (#20260610004910)

Bugfixes

• Dependency upgrade: net-0.56.0 (#20260611101315)
• Dependency upgrade: v4-4.8.0 (#20260615101359)

"1.161.2" (2026-06-09)

Bugfixes

• Dependency upgrade: v4-4.26.5 (#20260603103438)
• Dependency upgrade: codeql-action-4.36.1 (#20260603235051)
• Dependency upgrade: codeql-action-4.36.2 (#20260605101427)
• Fixed collection sequence helpers so nil iter.Seq values no longer panic and instead behave like empty sequences. (#20260608103100)
• Dependency upgrade: sync-0.21.0 (#20260609101327)
• Dependency upgrade: text-0.38.0 (#20260609101338)
• Dependency upgrade: sys-0.46.0 (#20260609133240)

"1.161.1" (2026-06-03)

Bugfixes

• 🐛 [frontmatter] Ensure that different formats with the same start fence are treated as distinct formats (#20260602103158)

"1.161.0" (2026-06-02)

Features

• ✨ [reflection] Introduced a not empty helper (#20260601231830)
• ✨ [collection] Added additional helpers to ease operation on collection (#20260602001604)

Improved Documentation

• 📖 [collection] Improve documentation (#20260601232922)

"1.160.1" (2026-05-29)

Bugfixes

• Fixed filesystem removal on macOS when deleting directories using unlink. (#202605290935)

"1.160.0" (2026-05-28)

Features

• ✨ [serialization] added helpers from extracting front matters from documents (#20260527190231)

"1.159.0" (2026-05-27)

Features

• ✨ [yaml] Added helpers for checking valid files extensions (#20260527132139)
• ✨ [json] Added helpers for checking valid files extensions (#20260527132146)
• ⚙️ [jsonschema] Extend JSON Schema validation with schema options and support for schemas defined in YAML. (#20260527132214)

Bugfixes

• Dependency upgrade: easyjson-0.9.2 (#20260526175306)
• Dependency upgrade: timberjack-1.4.5 (#20260527121614)

"1.158.0" (2026-05-26)

Features

• ⚡ add helpers for supporting json marshalling with better performance than encoding/json (#20260521144643)
• ✨ add helpers for serialising yaml (#20260521162032)
• ✨ add helpers to validate files against a JSON schema in jsonschema (#20260521183044)
• ✨ [filesystem] Added validation rules for checking that a file path has the required extension (#20260521184825)

Bugfixes

• Dependency upgrade: codeql-action-4.35.4 (#20260515131752)
• Dependency upgrade: v5-5.19.1 (#20260519161135)
• Dependency upgrade: sys-0.45.0 (#20260522102515)
• Dependency upgrade: crypto-0.52.0 (#20260522102520)
• Dependency upgrade: net-0.55.0 (#20260522102524)
• Dependency upgrade: spdx-0.1.4 (#20260525155040)
• Dependency upgrade: codeql-action-4.36.0 (#20260525155205)

"1.157.1" (2026-05-11)

Bugfixes

• Dependency upgrade: sys-0.43.0 (#20260409101816)
• Dependency upgrade: crypto-0.50.0 (#20260410101244)
• Dependency upgrade: mod-0.35.0 (#20260410101259)
• Dependency upgrade: net-0.53.0 (#20260410101300)
• Dependency upgrade: upload-artifact-7.0.1 (#20260413110322)
• Dependency upgrade: codeql-action-4.35.2 (#20260416101503)
• Dependency upgrade: v5-5.18.0 (#20260417101349)
• Dependency upgrade: zerolog-1.35.1 (#20260421101451)
• Dependency upgrade: v2-2.9.0 (#20260421101500)
• Dependency upgrade: timberjack-1.4.2 (#20260421101514)
• Dependency upgrade: zap-1.28.0 (#20260428101825)
• Dependency upgrade: v4-4.26.4 (#20260501114549)
• Dependency upgrade: spdx-0.1.3 (#20260504122618)
• Dependency upgrade: crypto-0.51.0 (#20260511154537)
• Dependency upgrade: net-0.54.0 (#20260511154553)
• Dependency upgrade: v5-5.19.0 (#20260511163359)
• Dependency upgrade: fetch-metadata-3.1.0 (#20260511163423)

Misc

• #20260507133219

"1.157.0" (2026-04-22)

Features

• ✨ Add support for specifying the directory in subprocess commands (#20260422120133)

"1.156.1" (2026-04-07)

Bugfixes

• Dependency upgrade: timberjack-1.4.1 (#20260403101304)

Misc

• #20260407112643

"1.156.0" (2026-04-01)

Features

• ✨ [collection] Add matching helpers for collection lookups that can be used in switch statements. (#20260401153128)

Bugfixes

• Dependency upgrade: v5-5.17.2 (#20260401114251)
• Dependency upgrade: v4-4.26.3 (#20260401114259)
• Dependency upgrade: codeql-action-4.35.1 (#20260401114422)

"1...

Release 1.166.1

Changelog

This document contains a history of significant changes which have been released for golang-utils. Please note that
beta releases are not included in this history.

"1.166.1" (2026-07-16)

Bugfixes

• 🐛 [casing] fix regression in acronym-aware casing so normal PascalCase names like NoKeyring do not become NOKeyring (#20260716125731)

"1.166.0" (2026-07-16)

Features

• ✨ [URL] add configurable URL canonicalisation and comparison helpers for normalised matching. (#202607161530)

"1.165.2" (2026-07-15)

Bugfixes

• 🐛 Strings/casing: recognise the codebase's I... interface naming convention when handling acronym-prefixed identifiers such as IHTTP. (#20260707151500)
• 🐛 Strings/casing: improve plural initialism handling so identifiers such as Urls can be normalised to URLs where appropriate. (#20260707151600)
• Dependency upgrade: text-0.40.0 (#20260709101319)
• Dependency upgrade: codeql-action-4.37.0 (#20260709101326)
• Dependency upgrade: net-0.57.0 (#20260709101336)
• Dependency upgrade: crypto-0.54.0 (#20260709101342)
• Dependency upgrade: sync-0.22.0 (#20260709101404)
• Dependency upgrade: sys-0.47.0 (#20260714172504)

"1.165.1" (2026-07-08)

Bugfixes

• 🐛 [casing] fix toPascalCase regression (#20260708165859)

"1.165.0" (2026-07-08)

Features

• ✨ [Retry] add composable retry options with jitter, retry budget, etc. to ease the definition of retry strategies. (#20260707125500)

Bugfixes

• Dependency upgrade: codeql-action-4.36.3 (#20260702101311)
• Dependency upgrade: text-0.39.0 (#20260707101311)
• 🐛 [casing] fix casing helpers so adjacent acronym runs like AESRSA are preserved in existing camelCase and PascalCase identifiers instead of collapsing to Aesrsa. (#20260708153417)

"1.164.1" (2026-07-01)

Bugfixes

• 🐛 [jsonschema] Added support for ignoring YAML alias and anchor helper fields during schema validation when explicitly requested. (#20260608112000)
• Dependency upgrade: crypto-0.53.0 (#20260609101342)
• Dependency upgrade: checkout-7 (#20260619101252)
• Dependency upgrade: cache-6 (#20260624101305)
• Dependency upgrade: upload-sarif-9cea5827c668a1fe7165dbce6e80c3f9cf3f83ac (#20260626101420)
• Dependency upgrade: v4-4.9.0 (#20260629101306)
• Dependency upgrade: v4-4.26.6 (#20260701101231)
• Dependency upgrade: upload-sarif-628fc3f124e68b0151f0d2a5d81e864ee1e42335 (#20260701101351)

"1.164.0" (2026-06-18)

Features

• ✨ [collection] Added function composition helpers including Combine, CombineRef, CombineWithError, and CombineRefWithError for composing mapping functions right-to-left. (#20260608105500)
• ✨ [collection] Added coalescing and merging helpers including Coalesce, CoalesceRef, MergeBy, and MergeByRef for compacting adjacent values and merging grouped values. (#20260608105600)

Bugfixes

• Dependency upgrade: mongo-driver-1.17.7 (#20260618154523)
• 🐛 [casing] fix the merging of rules rather than silently picking the latest defined (#20260618171355)

"1.163.0" (2026-06-18)

Features

• ✨ Added a package to change string casing but handling go initialisms (#20260608105000)

Bugfixes

• 🐛 [frontmatter] Ensure that if a file starts with a byte-order mark that it is still parsable (#20260601172808)

"1.162.0" (2026-06-16)

Features

• ✨ [collection] Add helpers such as First... Last... (#20260610004910)

Bugfixes

• Dependency upgrade: net-0.56.0 (#20260611101315)
• Dependency upgrade: v4-4.8.0 (#20260615101359)

"1.161.2" (2026-06-09)

Bugfixes

• Dependency upgrade: v4-4.26.5 (#20260603103438)
• Dependency upgrade: codeql-action-4.36.1 (#20260603235051)
• Dependency upgrade: codeql-action-4.36.2 (#20260605101427)
• Fixed collection sequence helpers so nil iter.Seq values no longer panic and instead behave like empty sequences. (#20260608103100)
• Dependency upgrade: sync-0.21.0 (#20260609101327)
• Dependency upgrade: text-0.38.0 (#20260609101338)
• Dependency upgrade: sys-0.46.0 (#20260609133240)

"1.161.1" (2026-06-03)

Bugfixes

• 🐛 [frontmatter] Ensure that different formats with the same start fence are treated as distinct formats (#20260602103158)

"1.161.0" (2026-06-02)

Features

• ✨ [reflection] Introduced a not empty helper (#20260601231830)
• ✨ [collection] Added additional helpers to ease operation on collection (#20260602001604)

Improved Documentation

• 📖 [collection] Improve documentation (#20260601232922)

"1.160.1" (2026-05-29)

Bugfixes

• Fixed filesystem removal on macOS when deleting directories using unlink. (#202605290935)

"1.160.0" (2026-05-28)

Features

• ✨ [serialization] added helpers from extracting front matters from documents (#20260527190231)

"1.159.0" (2026-05-27)

Features

• ✨ [yaml] Added helpers for checking valid files extensions (#20260527132139)
• ✨ [json] Added helpers for checking valid files extensions (#20260527132146)
• ⚙️ [jsonschema] Extend JSON Schema validation with schema options and support for schemas defined in YAML. (#20260527132214)

Bugfixes

• Dependency upgrade: easyjson-0.9.2 (#20260526175306)
• Dependency upgrade: timberjack-1.4.5 (#20260527121614)

"1.158.0" (2026-05-26)

Features

• ⚡ add helpers for supporting json marshalling with better performance than encoding/json (#20260521144643)
• ✨ add helpers for serialising yaml (#20260521162032)
• ✨ add helpers to validate files against a JSON schema in jsonschema (#20260521183044)
• ✨ [filesystem] Added validation rules for checking that a file path has the required extension (#20260521184825)

Bugfixes

• Dependency upgrade: codeql-action-4.35.4 (#20260515131752)
• Dependency upgrade: v5-5.19.1 (#20260519161135)
• Dependency upgrade: sys-0.45.0 (#20260522102515)
• Dependency upgrade: crypto-0.52.0 (#20260522102520)
• Dependency upgrade: net-0.55.0 (#20260522102524)
• Dependency upgrade: spdx-0.1.4 (#20260525155040)
• Dependency upgrade: codeql-action-4.36.0 (#20260525155205)

"1.157.1" (2026-05-11)

Bugfixes

• Dependency upgrade: sys-0.43.0 (#20260409101816)
• Dependency upgrade: crypto-0.50.0 (#20260410101244)
• Dependency upgrade: mod-0.35.0 (#20260410101259)
• Dependency upgrade: net-0.53.0 (#20260410101300)
• Dependency upgrade: upload-artifact-7.0.1 (#20260413110322)
• Dependency upgrade: codeql-action-4.35.2 (#20260416101503)
• Dependency upgrade: v5-5.18.0 (#20260417101349)
• Dependency upgrade: zerolog-1.35.1 (#20260421101451)
• Dependency upgrade: v2-2.9.0 (#20260421101500)
• Dependency upgrade: timberjack-1.4.2 (#20260421101514)
• Dependency upgrade: zap-1.28.0 (#20260428101825)
• Dependency upgrade: v4-4.26.4 (#20260501114549)
• Dependency upgrade: spdx-0.1.3 (#20260504122618)
• Dependency upgrade: crypto-0.51.0 (#20260511154537)
• Dependency upgrade: net-0.54.0 (#20260511154553)
• Dependency upgrade: v5-5.19.0 (#20260511163359)
• Dependency upgrade: fetch-metadata-3.1.0 (#20260511163423)

Misc

• #20260507133219

"1.157.0" (2026-04-22)

Features

• ✨ Add support for specifying the directory in subprocess commands (#20260422120133)

"1.156.1" (2026-04-07)

Bugfixes

• Dependency upgrade: timberjack-1.4.1 (#20260403101304)

Misc

• #20260407112643

"1.156.0" (2026-04-01)

Features

• ✨ [collection] Add matching helpers for collection lookups that can be used in switch statements. (#20260401153128)

Bugfixes

• Dependency upgrade: v5-5.17.2 (#20260401114251)
• Dependency upgrade: v4-4.26.3 (#20260401114259)
• Dependency upgrade: codeql-action-4.35.1 (#20260401114422)

"1.155.1" (2026-04-01)

Bugfixes

• Dependency upgrade: go-deadlock-0.3.8 (#20260318111151)
• Dependency upgrade: go-deadlock-0.3.9 (#20260319111313)
• Dependency upgrade: codeql-action-4.34.1 (#20260323112752)
• Dependency upgrade: fetch-metadata-3.0.0 (#20260327111335)
• Dependency upgrade: v5-5.17.1 (#20260330105540)
• Dependency upgrade: zerolog-1.35.0 (#20260330105546)
• Dependency upgrade: go-keyring-0.2.7 (#20260401093311)
• Dependency upgrade: spdx-0.1.2 (#20260401093438)

"1.155.0" (2026-03-18)

Features

• ✨ [field] Add a utility to set an optional field to nil if empty (#20260318100334)

"1.154.0" (2026-03-18)

Features

• ✨ [safecast] Adds safe numeric cast helpers, including generic value and reference casting, with clamping (#20260317181439)

"1.153.0" (2026-03-16)

Features

• ✨ [validation] Add logical rule set for ozzo rules (#20260316165348)

Bugfixes

• Dependency upgrade: codeql-action-4.33.0 (#20260316113247)

"1.152.0" (2026-03-13)

Features

• ✨ Introduced package [licensing] in order to...