Add Cldr.InvalidCurrencyError exception

Author: kipcole9

CHANGELOG.md

@@ -2,6 +2,14 @@
 
 **Note that `ex_cldr` version 2.39.0 and later are supported on Elixir 1.12 and later only.**
 
+## Cldr v2.46.0
+
+This is the changelog for Cldr v2.46.0 released on January 20th, 2026.  For older changelogs please consult the release tag on [GitHub](https://github.com/elixir-cldr/cldr/tags)
+
+### Enhancements
+
+* Adds an exception `Cldr.InvalidCurrencyCode` to allow differentiation between invalid and unknown currency codes. This is primarily to support between currency validation in [ex_money](https://github.com/kipcole9/money).
+
 ## Cldr v2.45.2
 
 This is the changelog for Cldr v2.45.2 released on January 19th, 2026.  For older changelogs please consult the release tag on [GitHub](https://github.com/elixir-cldr/cldr/tags)

lib/cldr.ex

@@ -2009,11 +2009,14 @@ defmodule Cldr do
       iex> Cldr.validate_currency("xtc")
       {:ok, :XTC}
 
+      iex> Cldr.validate_currency("ZZZ")
+      {:error, {Cldr.UnknownCurrencyError, "The currency \\"ZZZ\\" is unknown"}}
+
       iex> Cldr.validate_currency("invalid")
-      {:error, {Cldr.UnknownCurrencyError, "The currency \\"invalid\\" is invalid"}}
+      {:error, {Cldr.InvalidCurrencyError, "The currency \\"invalid\\" is invalid"}}
 
       iex> Cldr.validate_currency(:invalid)
-      {:error, {Cldr.UnknownCurrencyError, "The currency :invalid is invalid"}}
+      {:error, {Cldr.InvalidCurrencyError, "The currency :invalid is invalid"}}
 
   """
 
@@ -2024,10 +2027,11 @@ defmodule Cldr do
   def validate_currency(currency) when is_atom(currency) do
     currency
     |> Atom.to_string()
-    |> validate_currency
+    |> validate_currency()
     |> case do
-      {:error, _} -> {:error, unknown_currency_error(currency)}
-      ok -> ok
+      {:error, {Cldr.UnknownCurrencyError, _}} -> {:error, unknown_currency_error(currency)}
+      {:error, {Cldr.InvalidCurrencyError, _}} -> {:error, invalid_currency_error(currency)}
+      {:ok, currency} -> {:ok, currency}
     end
   end
 
@@ -2060,11 +2064,11 @@ defmodule Cldr do
   end
 
   def validate_currency(invalid_currency) do
-    {:error, unknown_currency_error(invalid_currency)}
+    {:error, invalid_currency_error(invalid_currency)}
   end
 
   @doc """
-  Returns an error tuple for an invalid currency.
+  Returns an error tuple for an unknown currency.
 
   ## Arguments
 
@@ -2076,12 +2080,33 @@ defmodule Cldr do
 
   ## Examples
 
-      iex> Cldr.unknown_currency_error("invalid")
-      {Cldr.UnknownCurrencyError, "The currency \\"invalid\\" is invalid"}
+      iex> Cldr.unknown_currency_error("XAB")
+      {Cldr.UnknownCurrencyError, "The currency \\"XAB\\" is unknown"}
 
   """
   def unknown_currency_error(currency) do
-    {Cldr.UnknownCurrencyError, "The currency #{inspect(currency)} is invalid"}
+    {Cldr.UnknownCurrencyError, "The currency #{inspect(currency)} is unknown"}
+  end
+
+  @doc """
+  Returns an error tuple for an invalid currency.
+
+  ## Arguments
+
+  * `currency` is any currency code **not** returned by `Cldr.known_currencies/0`
+
+  ## Returns
+
+  * `{:error, {Cldr.InvalidCurrencyError, message}}`
+
+  ## Examples
+
+      iex> Cldr.invalid_currency_error("invalid")
+      {Cldr.InvalidCurrencyError, "The currency \\"invalid\\" is invalid"}
+
+  """
+  def invalid_currency_error(currency) do
+    {Cldr.InvalidCurrencyError, "The currency #{inspect(currency)} is invalid"}
   end
 
   @doc """

lib/cldr/exception.ex

@@ -104,6 +104,17 @@ defmodule Cldr.FormatCompileError do
 end
 
 defmodule Cldr.UnknownCurrencyError do
+  @moduledoc """
+  Exception raised when there is an unknown currency code.
+  """
+  defexception [:message]
+
+  def exception(message) do
+    %__MODULE__{message: message}
+  end
+end
+
+defmodule Cldr.InvalidCurrencyError do
   @moduledoc """
   Exception raised when there is an invalid currency code.
   """

mix.exs

@@ -1,7 +1,7 @@
 defmodule Cldr.Mixfile do
   use Mix.Project
 
-  @version "2.45.2"
+  @version "2.46.0"
 
   def project do
     [

mix.lock

@@ -6,7 +6,7 @@
   "dialyxir": {:hex, :dialyxir, "1.4.7", "dda948fcee52962e4b6c5b4b16b2d8fa7d50d8645bbae8b8685c3f9ecb7f5f4d", [:mix], [{:erlex, ">= 0.2.8", [hex: :erlex, repo: "hexpm", optional: false]}], "hexpm", "b34527202e6eb8cee198efec110996c25c5898f43a4094df157f8d28f27d9efe"},
   "earmark_parser": {:hex, :earmark_parser, "1.4.44", "f20830dd6b5c77afe2b063777ddbbff09f9759396500cdbe7523efd58d7a339c", [:mix], [], "hexpm", "4778ac752b4701a5599215f7030989c989ffdc4f6df457c5f36938cc2d2a2750"},
   "erlex": {:hex, :erlex, "0.2.8", "cd8116f20f3c0afe376d1e8d1f0ae2452337729f68be016ea544a72f767d9c12", [:mix], [], "hexpm", "9d66ff9fedf69e49dc3fd12831e12a8a37b76f8651dd21cd45fcf5561a8a7590"},
-  "ex_doc": {:hex, :ex_doc, "0.39.3", "519c6bc7e84a2918b737aec7ef48b96aa4698342927d080437f61395d361dcee", [:mix], [{:earmark_parser, "~> 1.4.44", [hex: :earmark_parser, repo: "hexpm", optional: false]}, {:makeup_c, ">= 0.1.0", [hex: :makeup_c, repo: "hexpm", optional: true]}, {:makeup_elixir, "~> 0.14 or ~> 1.0", [hex: :makeup_elixir, repo: "hexpm", optional: false]}, {:makeup_erlang, "~> 0.1 or ~> 1.0", [hex: :makeup_erlang, repo: "hexpm", optional: false]}, {:makeup_html, ">= 0.1.0", [hex: :makeup_html, repo: "hexpm", optional: true]}], "hexpm", "0590955cf7ad3b625780ee1c1ea627c28a78948c6c0a9b0322bd976a079996e1"},
+  "ex_doc": {:hex, :ex_doc, "0.40.0", "2635974389b80fd3ca61b0f993d459dad05b4a8f9b069dcfbbc5f6a8a6aef60e", [:mix], [{:earmark_parser, "~> 1.4.44", [hex: :earmark_parser, repo: "hexpm", optional: false]}, {:makeup_c, ">= 0.1.0", [hex: :makeup_c, repo: "hexpm", optional: true]}, {:makeup_elixir, "~> 0.14 or ~> 1.0", [hex: :makeup_elixir, repo: "hexpm", optional: false]}, {:makeup_erlang, "~> 0.1 or ~> 1.0", [hex: :makeup_erlang, repo: "hexpm", optional: false]}, {:makeup_html, ">= 0.1.0", [hex: :makeup_html, repo: "hexpm", optional: true]}], "hexpm", "c040735250e2752b6e1102eeb4aa3f1dca74c316db873ae09f955d42136e7e5b"},
   "expo": {:hex, :expo, "1.1.1", "4202e1d2ca6e2b3b63e02f69cfe0a404f77702b041d02b58597c00992b601db5", [:mix], [], "hexpm", "5fb308b9cb359ae200b7e23d37c76978673aa1b06e2b3075d814ce12c5811640"},
   "gettext": {:hex, :gettext, "1.0.2", "5457e1fd3f4abe47b0e13ff85086aabae760497a3497909b8473e0acee57673b", [:mix], [{:expo, "~> 0.5.1 or ~> 1.0", [hex: :expo, repo: "hexpm", optional: false]}], "hexpm", "eab805501886802071ad290714515c8c4a17196ea76e5afc9d06ca85fb1bfeb3"},
   "jason": {:hex, :jason, "1.4.4", "b9226785a9aa77b6857ca22832cffa5d5011a667207eb2a0ad56adb5db443b8a", [:mix], [{:decimal, "~> 1.0 or ~> 2.0", [hex: :decimal, repo: "hexpm", optional: true]}], "hexpm", "c5eb0cab91f094599f94d55bc63409236a8ec69a21a67814529e8d5f6cc90b3b"},