ecto_box

# Mix.install([
#   {:req, "~> 0.3.11"}
# ])

nil

Usage example

defmodule GithubClient do
  import EctoBox
  import EctoBox.HttpResponseMapper, only: [extract_body: 3]

  defschema Owner do
    field(:id, :integer)
    field(:login, :string)
  end

  defschema Repository do
    field(:full_name, :string)
    field(:has_downloads, :boolean)
    field(:owner, Owner)
  end

  defschema Error do
    field(:message, :string)
  end

  @type error :: Error.t() | Exception.t() | atom

  @spec get_public_repo(binary()) :: {:ok, Repository.t()} | {:error, error()}
  def get_public_repo(name) do
    "https://api.github.com/repos/#{name}"
    |> Req.get()
    |> extract_body(Repository, Error)
  end
end

{:module, GithubClient, <<70, 79, 82, 49, 0, 0, 9, ...>>, {:get_public_repo, 1}}

The request below returns HTTP 200 - and should be converted into Repository schema:

GithubClient.get_public_repo("wojtekmach/req")

{:ok,
 %GithubClient.Repository{
   full_name: "wojtekmach/req",
   has_downloads: true,
   owner: %GithubClient.Owner{id: 76071, login: "wojtekmach"}
 }}

While this request returns HTTP 400 and will be converted to Error schema:

GithubClient.get_public_repo("foo/bar")

{:error, %GithubClient.Error{message: "Not Found"}}