Reference / Changelog

Changelog

All notable changes to Flora. The project follows semantic versioning.

v1.6.2 — 2026-06-09

• Fixed: Dir now sorts fragments by filename consistently across operating systems.
• Fixed: a panic when decoding a TOML array of tables into a slice of pointers.
• Docs: expanded the precedence section with a worked example.

v1.6.0 — 2026-04-21

• Added: flora explain command to show which source set a key's winning value.
• Added: --redact flag on dump for keys tagged secret.
• Changed: validation now reports all failing fields in a single error instead of stopping at the first.

v1.5.1 — 2026-02-14

• Fixed: environment keys with a trailing separator are no longer treated as nested.
• Fixed: Optional() sources no longer mask read errors other than "not found".

v1.5.0 — 2025-12-02

• Added: time.Duration and time.Time decoding.
• Added: WithStrict() to error on unknown keys.
• Deprecated: LoadFile — use Load with File(). Scheduled for removal in v2.

v1.4.0 — 2025-09-18

• Added: pluggable Decoder interface and Register for custom formats.
• Added: INI dialect support.
• Performance: roughly 30% less allocation when merging large maps.

v1.0.0 — 2025-05-06

• First stable release. Layered sources, struct decoding, environment overrides, and validation.
• Public v1 API frozen.