physium / faraday_middleware

Various Faraday middlewares for Faraday-based API wrappers

Faraday Middleware

A collection of useful Faraday middleware. See the documentation.

gem install faraday_middleware

Dependencies

Ruby >= 2.3.0

As of v0.16.0, faraday and faraday_middleware no longer officially support JRuby or Rubinius.

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

require 'faraday_middleware'

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