Ivar is an adapter based HTTP client that provides the ability to build composable HTTP requests.
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
config refactor to adapter pattern Jul 26, 2017
lib add options method and tests (#7) Oct 5, 2017
test add options method and tests (#7) Oct 5, 2017
.gitignore added new function Feb 21, 2017
.travis.yml updated travis file Apr 7, 2017
LICENSE Initial commit Feb 21, 2017
README.md fixed typo in README Jul 27, 2017
mix.exs bumped to 0.10.1 Aug 30, 2017
mix.lock refactor to adapter pattern Jul 26, 2017

README.md

Build Status Deps Status Hex Version Join the chat at https://gitter.im/swelham/ivar

Ivar

Ivar is an adapter based HTTP client that provides the ability to build composable HTTP requests.

The key goals of Ivar are to allow requests to be constructed in a composable manner (pipeline friendly) and to simplify building, sending and receiving requests for a number of well known http clients.

Supported Adapters

HTTP Client Adapter
HTTPoison ivar_httpoison

Usage

Add ivar to your list of dependencies in mix.exs, plus the http adapter you are going to use:

def deps do
  [
    {:ivar, "~> 0.9.0"},
    {:ivar_httpoison, "~> 0.1.0"}
  ]
end

Setup up the config for your chosen adapater

config :ivar,
  adapter: Ivar.HTTPoison

Basic usage

Ivar.get("https://example.com")
|> Ivar.send
|> Ivar.unpack
# {"<!doctype html>\n<html>...", %HTTPoison.Response{}}

JSON encoding/decoding

Ivar uses the Poison library for encoding and decoding JSON, so make sure you have it listed along side Ivar in your mix.exs.

def deps do
  [
    {:ivar, "~> 0.9.0"},
    {:poison, "~> 3.0"},
    ...
  ]
end

You can then specify that you want to send JSON when putting the request body. If the response contains the application/json content type header, the Ivar.unpack function will then decode the response for you.

Ivar.post("https://some-echo-server")
|> Ivar.put_body(%{some: "data"}, :json)
|> Ivar.send
|> Ivar.unpack
# {%{some: "data"}, %HTTPoison.Response{}}

Real world example

This is simplified extract from a real world application where Ivar is being used to send email via the mailgun service.

url = "https://api.mailgun.net/v3/domain.com/messages"
mail_data = %{to: "someone@example.com", ...}
files = [{"inline", File.read!("elixir.png"), "elixir.png"}, ...]

Ivar.new(:post, url)
|> Ivar.put_auth({"api", "mailgun_api_key"}, :basic)
|> Ivar.put_body(mail_data, :url_encoded)
|> Ivar.put_files(files)
|> Ivar.send