xema v0.11.0 Xema.ValidationError exception View Source

Raised when a validation fails.

Link to this section Summary

Types

opts()

path()

t()

Functions

format_error(error)

This function returns an error message for an error or error tuple.

travers_errors(error, acc, fun, opts \\ [])

Traverse the error tree and invokes the given function.

Link to this section Types

opts()

opts() :: [] | [{:path, path()}]

path()

path() :: [atom() | integer() | String.t()]

t()

t() :: %Xema.ValidationError{
  __exception__: term(),
  message: String.t() | nil,
  reason: map()
}

Link to this section Functions

format_error(error)

format_error({:error, map()} | map()) :: String.t()

This function returns an error message for an error or error tuple.

Example

iex> schema = Xema.new(:integer)
iex> schema
...>   |> Xema.Validator.validate(1.1)
...>   |> Xema.ValidationError.format_error()
"Expected :integer, got 1.1."

travers_errors(error, acc, fun, opts \\ [])

travers_errors(
  {:error, map()} | map(),
  acc,
  (map(), path(), acc -> acc),
  opts()
) :: acc
when acc: any()

Traverse the error tree and invokes the given function.

Example

iex> fun = fn _error, path, acc ->
...>   ["Error at " <> inspect(path) | acc]
...> end
iex>
iex> schema = Xema.new(
...>   properties: %{
...>     int: :integer,
...>     names: {:list, items: :string},
...>     num: [any_of: [:integer, :float]]
...>   }
...> )
iex>
iex> data = %{int: "x", names: [1, "x", 5], num: :foo}
iex>
iex> schema
...>   |> Xema.Validator.validate(data)
...>   |> Xema.ValidationError.travers_errors([], fun)
[
  "Error at [:num]",
  "Error at [:names, 2]",
  "Error at [:names, 0]",
  "Error at [:names]",
  "Error at [:int]",
  "Error at []"
]