Faraday Middleware

A collection of useful Faraday middleware. See the documentation.

gem install faraday_middleware

Dependencies

Some dependent libraries are needed only when using specific middleware:

Middleware	Library	Notes
FaradayMiddleware::Instrumentation	activesupport
FaradayMiddleware::OAuth	simple_oauth
FaradayMiddleware::ParseXml	multi_xml
FaradayMiddleware::ParseYaml	safe_yaml	Not backwards compatible with versions of this middleware prior to faraday_middleware v0.12. See code comments for alternatives.
FaradayMiddleware::Mashify	hashie
FaradayMiddleware::Rashify	rash_alt	Make sure to uninstall original rash gem to avoid conflict.

Examples

``` rb require ‘faraday_middleware’

in Faraday 0.8 or above:

connection = Faraday.new ‘http://example.com/api’ do |conn| conn.request :oauth2, ‘TOKEN’ conn.request :json

conn.response :xml, :content_type => /\bxml$/ conn.response :json, :content_type => /\bjson$/

conn.use :instrumentation conn.adapter Faraday.default_adapter end

with Faraday 0.7:

connection = Faraday.new ‘http://example.com/api’ do |builder| builder.use FaradayMiddleware::OAuth2, ‘TOKEN’ builder.use FaradayMiddleware::EncodeJson

builder.use FaradayMiddleware::ParseXml, :content_type => /\bxml$/ builder.use FaradayMiddleware::ParseJson, :content_type => /\bjson$/

builder.use FaradayMiddleware::Instrumentation builder.adapter Faraday.default_adapter end ```