Skip to content

Localize version 0.29.0

Choose a tag to compare

@kipcole9 kipcole9 released this 11 May 12:47
· 96 commits to main since this release

[0.29.0] — May 11th, 2026

Behaviour Change

  • Localize.Currency.currency_for_code/2 now returns the new Localize.CurrencyNotLocalizedError (instead of UnknownCurrencyError) when the currency code is valid but the locale has no display data for it. UnknownCurrencyError is now reserved for codes that aren't recognised ISO 4217 or registered custom currencies.

Enhancements

  • Localize.Currency.currency_for_code/2 accepts a new :fallback option which walks the CLDR parent locale chain and the application default locale before failing. Thanks to @neilberkman for the PR.

  • Localize.Locale.get/3 accepts a new :fallback_to_default option for a final-step fallback after any :fallback parent walk. Accepts true (use Localize.default_locale/0), or an atom/string/Localize.LanguageTag for a specific locale.

  • Add :iso_3166 option to Localize.Territory.territory_codes/1 to return only ISO 3166 codes (not aggregate territories).