Splode.Error behaviour (splode v0.3.2)

Use this module to create an aggregatable error.

For example:

defmodule MyApp.Errors.InvalidArgument do
  use Splode.Error, fields: [:name, :message], class: :invalid

  def message(%{name: name, message: message}) do
    "Invalid argument #{name}: #{message}"
  end
end

Summary

Callbacks

error_class?()

from_json(map)

keyword_list_options?()

Whether a keyword list should be treated as options for building this error.

splode_error?()

Types

t()

@type t() :: Exception.t()

Callbacks

error_class?()

@callback error_class?() :: boolean()

from_json(map)

@callback from_json(map()) :: struct()

keyword_list_options?()

@callback keyword_list_options?() :: boolean()

Whether a keyword list should be treated as options for building this error.

Only consulted for the module configured as a Splode's :unknown_error. When it returns true — the default — a list that satisfies Keyword.keyword?/1 is destructured into :error, :vars and (if declared) :value, rather than being converted like any other term.

That is surprising for terms that happen to parse as keyword lists, such as OTP exit reasons:

Keyword.keyword?([{:noproc, {GenServer, :call, [:some_name, :ping, 5000]}}])
#=> true

Returning false opts out: keyword lists are then converted like any other list, so to_error(message: "it broke") produces two errors rather than one, and to_error([]) produces an empty error class rather than an unknown error. The default will change to false in the next major version.

defmodule MyApp.Errors.Unknown do
  use Splode.Error, fields: [:error], class: :unknown

  def keyword_list_options?, do: false
end

splode_error?()

@callback splode_error?() :: boolean()