Tesla.Adapter behaviour (tesla v1.5.1) View Source

The adapter specification.

Adapter is a module that denormalize request data stored in Tesla.Env in order to make request with lower level http client (e.g. :httpc or :hackney) and normalize response data in order to store it back to Tesla.Env. It has to implement Tesla.Adapter.call/2.

Writing custom adapter

Create a module implementing Tesla.Adapter.call/2.

See Tesla.Adapter.call/2 for details.

Examples

defmodule MyProject.CustomAdapter do
  alias Tesla.Multipart

  @behaviour Tesla.Adapter

  @override_defaults [follow_redirect: false]

  @impl Tesla.Adapter
  def call(env, opts) do
    opts = Tesla.Adapter.opts(@override_defaults, env, opts)

    with {:ok, {status, headers, body}} <- request(env.method, env.body, env.headers, opts) do
      {:ok, normalize_response(env, status, headers, body)}
    end
  end

  defp request(_method, %Stream{}, _headers, _opts) do
    {:error, "stream not supported by adapter"}
  end

  defp request(_method, %Multipart{}, _headers, _opts) do
    {:error, "multipart not supported by adapter"}
  end

  defp request(method, body, headers, opts) do
    :lower_level_http.request(method, body, denormalize_headers(headers), opts)
  end

  defp denormalize_headers(headers), do: ...
  defp normalize_response(env, status, headers, body), do: %Tesla.Env{env | ...}
end

Link to this section Summary

Callbacks

Invoked when a request runs.

Functions

Helper function that merges all adapter options.

Link to this section Callbacks

Specs

call(env :: Tesla.Env.t(), options :: any()) :: Tesla.Env.result()

Invoked when a request runs.

Arguments

  • env - Tesla.Env struct that stores request/response data
  • options - middleware options provided by user

Link to this section Functions

Link to this function

opts(defaults \\ [], env, opts)

View Source

Specs

Helper function that merges all adapter options.

Arguments

  • defaults (optional) - useful to override lower level http client default configuration
  • env - Tesla.Env struct
  • opts - options provided to Tesla.Builder.adapter/2 macro

Precedence rules

  • config from opts overrides config from defaults when same key is encountered
  • config from env overrides config from both defaults and opts when same key is encountered