DataSpecs Plug.

NOTE: this module is available if you include the optional dependency plug.

This module can be used to plug a "Jason.decode! -> DataSpecs.cast" pipeline in your routes.

For example:

defmodule Api.Router.Something do
  use Plug.Router
  import DataSpecs.Plug.Cast, only: [typeref: 2, value: 1]

  plug :match
  plug DataSpecs.Plug.Cast
  plug :dispatch

  post "/foo", typeref(Api.Model.Foo, :t) do
    %Api.Model.Foo{...} = value(conn)
    ...
  end
end

defmodule Api.Model.Foo do
  defmodule Bar do
    @enforce_keys [:b1]
    defstruct @enforce_keys ++ [:b2]

    @type t :: %__MODULE__{
            b1: number(),
            b2: nil | String.t()
          }
  end

  @enforce_keys [:a, :bars]
  defstruct @enforce_keys

  @type t :: %__MODULE__{
          a: non_neg_integer(),
          bars: [Bar.t()]
        }
end