Use `Tesla.Builder` module to create API wrappers.
For example
```ex
defmodule GitHub do
use Tesla.Builder
with Tesla.Middleware.BaseUrl, "https://api.github.com"
with Tesla.Middleware.Headers, %{'Authorization' => 'xyz'}
with Tesla.Middleware.EncodeJson
with Tesla.Middleware.DecodeJson
+ adapter Tesla.Adapter.Ibrowse
+
def user_repos(login) do
get("/user/" <> login <> "/repos")
end
end
```
Then use it like this:
```ex
GitHub.get("/user/teamon/repos")
GitHub.user_repos("teamon")
```
+## Adapters
+
+Tesla has support for different adapters that do the actual HTTP request processing.
+
+### ibrowse
+
+Tesla has built-in support for [ibrowse](https://github.com/cmullaparthi/ibrowse) Erlang HTTP client.
+
+To use it simply include `adapter Tesla.Adapter.Ibrowse` line in your API client definition.
+
+NOTE: Remember to start ibrowse first with `Tesla.Adapter.Ibrowse.start` before executing any requests.
+
+ibrowse is also the default adapter when using generic `Tesla.get(...)` etc. methods.
+
+### Test / Mock
+
+When testing it might be useful to use simple function as adapter:
+
+```ex
+defmodule MyApi do
+ use Tesla
+
+ adapter fn (env) ->
+ case env.url do
+ "/" -> {200, %{}, "home"}
+ "/about" -> {200, %{}, "about us"}
+ end
+ end
+end
+```
+
+
+
+
+## Middleware
+
+### Basic
+
+- `Tesla.Middleware.BaseUrl` - set base url for all request
+- `Tesla.Middleware.Headers` - set request headers
+
+### JSON
+NOTE: requires [exjsx](https://github.com/talentdeficit/exjsx) as dependency
+
+- `Tesla.Middleware.DecodeJson` - decode response body as JSON
+- `Tesla.Middleware.EncodeJson` - endode request body as JSON
+
+If you are using different json library writing middleware should be straightforward. See [link to json.ex] for implementation.
+
+
## Dynamic middleware
All methods can take a middleware function as the first parameter.
This allow to use convinient syntax for modyfiyng the behaviour in runtime.
Consider the following case: GitHub API can be accessed using OAuth token authorization.
We can't use `with Tesla.Middleware.Headers, %{'Authorization' => 'token here'}` since this would be compiled only once and there is no way to insert dynamic user token.
Instead, we can use `Tesla.build_client` to create a dynamid middleware function: