add Ecto.Adapters.SQL.Constraint

Author: petermueller

lib/ecto/adapters/sql.ex

@@ -658,6 +658,7 @@ defmodule Ecto.Adapters.SQL do
     sql_call(adapter_meta, :query_many, [sql], params, opts)
   end
 
+  @doc false
   def to_constraints(adapter_meta, opts, err, err_opts) do
     %{constraint_handler: constraint_handler} = adapter_meta
     constraint_handler = Keyword.get(opts, :constraint_handler) || constraint_handler

lib/ecto/adapters/sql/constraint.ex

@@ -0,0 +1,19 @@
+defmodule Ecto.Adapters.SQL.Constraint do
+  @moduledoc """
+  Specifies the constraint handling API
+  """
+
+  @doc """
+  Receives the exception returned by `c:Ecto.Adapters.SQL.Connection.query/4`.
+
+  The constraints are in the keyword list and must return the
+  constraint type, like `:unique`, and the constraint name as
+  a string, for example:
+
+      [unique: "posts_title_index"]
+
+  Must return an empty list if the error does not come
+  from any constraint.
+  """
+  @callback to_constraints(exception :: Exception.t(), options :: Keyword.t()) :: Keyword.t()
+end