tesla

v0.9.0

tesla v0.9.0 Tesla View Source

A HTTP toolkit for building API clients using middlewares

Include Tesla module in your api client:

defmodule ExampleApi do
  use Tesla

  plug Tesla.Middleware.BaseUrl, "http://api.example.com"
  plug Tesla.Middleware.JSON
end

Link to this section Summary

Types

option()

Functions

adapter(module, custom)
alias(key)
build_adapter(fun)
build_client(pre, post \\ [])

Dynamically build client from list of middlewares

build_url(url, query)
default_adapter()
default_middleware()
delete(url)

Perform a DELETE request. See request/1 or request/2 for options definition

delete(client, url)

Perform a DELETE request. See request/1 or request/2 for options definition

delete(client, url, options)

Perform a DELETE request. See request/1 or request/2 for options definition

get(url)

Perform a GET request. See request/1 or request/2 for options definition

get(client, url)

Perform a GET request. See request/1 or request/2 for options definition

get(client, url, options)

Perform a GET request. See request/1 or request/2 for options definition

head(url)

Perform a HEAD request. See request/1 or request/2 for options definition

head(client, url)

Perform a HEAD request. See request/1 or request/2 for options definition

head(client, url, options)

Perform a HEAD request. See request/1 or request/2 for options definition

options(url)

Perform a OPTIONS request. See request/1 or request/2 for options definition

options(client, url)

Perform a OPTIONS request. See request/1 or request/2 for options definition

options(client, url, options)

Perform a OPTIONS request. See request/1 or request/2 for options definition

patch(url, body)

Perform a PATCH request. See request/1 or request/2 for options definition

patch(client, url, body)

Perform a PATCH request. See request/1 or request/2 for options definition

patch(client, url, body, options)

Perform a PATCH request. See request/1 or request/2 for options definition

perform_request(module, client \\ nil, options)
post(url, body)

Perform a POST request. See request/1 or request/2 for options definition

post(client, url, body)

Perform a POST request. See request/1 or request/2 for options definition

post(client, url, body, options)

Perform a POST request. See request/1 or request/2 for options definition

prepare(module, stack)
put(url, body)

Perform a PUT request. See request/1 or request/2 for options definition

put(client, url, body)

Perform a PUT request. See request/1 or request/2 for options definition

put(client, url, body, options)

Perform a PUT request. See request/1 or request/2 for options definition

put_opt(env, key, value)
request(options)

Perform a request. See request/2 for available options

request(client, options)

Perform a request using client function

run(env, list)
run_default_adapter(env, opts \\ [])
trace(url)

Perform a TRACE request. See request/1 or request/2 for options definition

trace(client, url)

Perform a TRACE request. See request/1 or request/2 for options definition

trace(client, url, options)

Perform a TRACE request. See request/1 or request/2 for options definition

Link to this section Types

Link to this type option() View Source 
option ::
  {:method, Tesla.Env.method} |
  {:url, Tesla.Env.url} |
  {:query, Tesla.Env.query} |
  {:headers, Tesla.Env.headers} |
  {:body, Tesla.Env.body} |
  {:opts, Tesla.Env.opts}

Link to this section Functions

Link to this macro build_client(pre, post \\ []) View Source (macro)

Dynamically build client from list of middlewares.

defmodule ExampleAPI do
  use Tesla

  def new(token) do
    Tesla.build_client([
      {Tesla.Middleware.Headers, %{"Authorization" => token}}
    ])
  end
end

client = ExampleAPI.new(token: "abc")
client |> ExampleAPI.get("/me")
Link to this function delete(url) View Source 
delete(Tesla.Env.url) :: Tesla.Env.t

Perform a DELETE request. See request/1 or request/2 for options definition.

Example

ExampleApi.delete("/users")
Link to this function delete(client, url) View Source 
delete(Tesla.Env.client, Tesla.Env.url) :: Tesla.Env.t
delete(Tesla.Env.url, [option]) :: Tesla.Env.t

Perform a DELETE request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.delete("/users")
ExampleApi.delete("/users", query: [page: 1])
Link to this function delete(client, url, options) View Source 
delete(Tesla.Env.client, Tesla.Env.url, [option]) :: Tesla.Env.t

Perform a DELETE request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.delete("/users", query: [page: 1])
Link to this function get(url) View Source 
get(Tesla.Env.url) :: Tesla.Env.t

Perform a GET request. See request/1 or request/2 for options definition.

Example

ExampleApi.get("/users")
Link to this function get(client, url) View Source 
get(Tesla.Env.client, Tesla.Env.url) :: Tesla.Env.t
get(Tesla.Env.url, [option]) :: Tesla.Env.t

Perform a GET request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.get("/users")
ExampleApi.get("/users", query: [page: 1])
Link to this function get(client, url, options) View Source 
get(Tesla.Env.client, Tesla.Env.url, [option]) :: Tesla.Env.t

Perform a GET request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.get("/users", query: [page: 1])
Link to this function head(url) View Source 
head(Tesla.Env.url) :: Tesla.Env.t

Perform a HEAD request. See request/1 or request/2 for options definition.

Example

ExampleApi.head("/users")
Link to this function head(client, url) View Source 
head(Tesla.Env.client, Tesla.Env.url) :: Tesla.Env.t
head(Tesla.Env.url, [option]) :: Tesla.Env.t

Perform a HEAD request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.head("/users")
ExampleApi.head("/users", query: [page: 1])
Link to this function head(client, url, options) View Source 
head(Tesla.Env.client, Tesla.Env.url, [option]) :: Tesla.Env.t

Perform a HEAD request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.head("/users", query: [page: 1])
Link to this function options(url) View Source 
options(Tesla.Env.url) :: Tesla.Env.t

Perform a OPTIONS request. See request/1 or request/2 for options definition.

Example

ExampleApi.options("/users")
Link to this function options(client, url) View Source 
options(Tesla.Env.client, Tesla.Env.url) :: Tesla.Env.t
options(Tesla.Env.url, [option]) :: Tesla.Env.t

Perform a OPTIONS request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.options("/users")
ExampleApi.options("/users", query: [page: 1])
Link to this function options(client, url, options) View Source 
options(Tesla.Env.client, Tesla.Env.url, [option]) :: Tesla.Env.t

Perform a OPTIONS request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.options("/users", query: [page: 1])
Link to this function patch(url, body) View Source 
patch(Tesla.Env.url, Tesla.Env.body) :: Tesla.Env.t

Perform a PATCH request. See request/1 or request/2 for options definition.

Example

ExampleApi.patch("/users", %{name: "Jon"})
Link to this function patch(client, url, body) View Source 
patch(Tesla.Env.client, Tesla.Env.url, Tesla.Env.body) :: Tesla.Env.t
patch(Tesla.Env.url, Tesla.Env.body, [option]) :: Tesla.Env.t

Perform a PATCH request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.patch("/users", %{name: "Jon"})
ExampleApi.patch("/users", %{name: "Jon"}, query: [scope: "admin"])
Link to this function patch(client, url, body, options) View Source 
patch(Tesla.Env.client, Tesla.Env.url, Tesla.Env.body, [option]) :: Tesla.Env.t

Perform a PATCH request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.patch("/users", %{name: "Jon"}, query: [scope: "admin"])
Link to this function perform_request(module, client \\ nil, options) View Source
Link to this function post(url, body) View Source 
post(Tesla.Env.url, Tesla.Env.body) :: Tesla.Env.t

Perform a POST request. See request/1 or request/2 for options definition.

Example

ExampleApi.post("/users", %{name: "Jon"})
Link to this function post(client, url, body) View Source 
post(Tesla.Env.client, Tesla.Env.url, Tesla.Env.body) :: Tesla.Env.t
post(Tesla.Env.url, Tesla.Env.body, [option]) :: Tesla.Env.t

Perform a POST request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.post("/users", %{name: "Jon"})
ExampleApi.post("/users", %{name: "Jon"}, query: [scope: "admin"])
Link to this function post(client, url, body, options) View Source 
post(Tesla.Env.client, Tesla.Env.url, Tesla.Env.body, [option]) :: Tesla.Env.t

Perform a POST request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.post("/users", %{name: "Jon"}, query: [scope: "admin"])
Link to this function put(url, body) View Source 
put(Tesla.Env.url, Tesla.Env.body) :: Tesla.Env.t

Perform a PUT request. See request/1 or request/2 for options definition.

Example

ExampleApi.put("/users", %{name: "Jon"})
Link to this function put(client, url, body) View Source 
put(Tesla.Env.client, Tesla.Env.url, Tesla.Env.body) :: Tesla.Env.t
put(Tesla.Env.url, Tesla.Env.body, [option]) :: Tesla.Env.t

Perform a PUT request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.put("/users", %{name: "Jon"})
ExampleApi.put("/users", %{name: "Jon"}, query: [scope: "admin"])
Link to this function put(client, url, body, options) View Source 
put(Tesla.Env.client, Tesla.Env.url, Tesla.Env.body, [option]) :: Tesla.Env.t

Perform a PUT request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.put("/users", %{name: "Jon"}, query: [scope: "admin"])
Link to this function put_opt(env, key, value) View Source
Link to this function request(options) View Source 
request([option]) :: Tesla.Env.t

Perform a request. See request/2 for available options.

Link to this function request(client, options) View Source 
request(Tesla.Env.client, [option]) :: Tesla.Env.t

Perform a request using client function

Options:

  • :method - the request method, one of [:head, :get, :delete, :trace, :options, :post, :put, :patch]
  • :url - either full url e.g. “http://example.com/some/path” or just “/some/path” if using Tesla.Middleware.BaseUrl
  • :query - a keyword list of query params, e.g. [page: 1, per_page: 100]
  • :headers - a keyworld list of headers, e.g. [{"content-type", "text/plain"}]

  • :body - depends on used middleware:

    • by default it can be a binary
    • if using e.g. JSON encoding middleware it can be a nested map
    • if adapter supports it it can be a Stream with any of the above
  • :opts - custom, per-request middleware or adapter options

Examples:

ExampleApi.request(method: :get, url: "/users/path")

You can also use shortcut methods like:

ExampleApi.get("/users/1")

or

myclient |> ExampleApi.post("/users", %{name: "Jon"})
Link to this function run_default_adapter(env, opts \\ []) View Source
Link to this function trace(url) View Source 
trace(Tesla.Env.url) :: Tesla.Env.t

Perform a TRACE request. See request/1 or request/2 for options definition.

Example

ExampleApi.trace("/users")
Link to this function trace(client, url) View Source 
trace(Tesla.Env.client, Tesla.Env.url) :: Tesla.Env.t
trace(Tesla.Env.url, [option]) :: Tesla.Env.t

Perform a TRACE request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.trace("/users")
ExampleApi.trace("/users", query: [page: 1])
Link to this function trace(client, url, options) View Source 
trace(Tesla.Env.client, Tesla.Env.url, [option]) :: Tesla.Env.t

Perform a TRACE request. See request/1 or request/2 for options definition.

Example

myclient |> ExampleApi.trace("/users", query: [page: 1])