Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lostisland/faraday_middleware

Various Faraday middlewares for Faraday-based API wrappers
https://github.com/lostisland/faraday_middleware

Last synced: about 2 months ago
JSON representation

Various Faraday middlewares for Faraday-based API wrappers

Host: GitHub
URL: https://github.com/lostisland/faraday_middleware
Owner: lostisland
License: mit
Created: 2010-06-28T20:13:32.000Z (about 14 years ago)
Default Branch: main
Last Pushed: 2024-06-05T06:30:17.000Z (4 months ago)
Last Synced: 2024-07-26T10:39:15.957Z (about 2 months ago)
Language: Ruby
Homepage:
Size: 427 KB
Stars: 555
Watchers: 21
Forks: 205
Open Issues: 11
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md

Awesome Lists containing this project

awesome-faraday - json - encode/decode JSON requests and responses (Middleware)

README

        Faraday Middleware

==================

[![Gem Version](https://badge.fury.io/rb/faraday_middleware.svg)](https://rubygems.org/gems/faraday_middleware)

![GitHub Actions CI](https://github.com/lostisland/faraday_middleware/workflows/CI/badge.svg)

A collection of useful [Faraday][] middleware. [See the documentation][docs].

    gem install faraday_middleware

## ⚠️ DEPRECATION WARNING ⚠️

As highlighted in Faraday's [UPGRADING](https://github.com/lostisland/faraday/blob/main/UPGRADING.md) guide, `faraday_middleware` is DEPRECATED, and will not be updated to support Faraday 2.0.

If you rely on `faraday_middleware` in your project and would like to support Faraday 2.0:

* The `json` middleware (request and response) are now both bundled with Faraday 🙌

* The `instrumentation` middleware is bundled with Faraday

* All other middlewares, they'll be re-released as independent gems compatible with both Faraday v1 and v2, look for [`awesome-faraday`](https://github.com/lostisland/awesome-faraday)

Most of the middlewares are up for adoption, contributors that would like to maintain them.

If you'd like to maintain any middleware, have any question or need any help, we're here!

Please reach out opening an issue or a discussion.

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](https://github.com/lostisland/faraday_middleware/blob/main/lib/faraday_middleware/instrumentation.rb) | [`activesupport`](https://rubygems.org/gems/activesupport) |       |

| [FaradayMiddleware::OAuth](https://github.com/lostisland/faraday_middleware/blob/main/lib/faraday_middleware/request/oauth.rb)    | [`simple_oauth`](https://rubygems.org/gems/simple_oauth) |       |

| [FaradayMiddleware::ParseXml](https://github.com/lostisland/faraday_middleware/blob/main/lib/faraday_middleware/response/parse_xml.rb) | [`multi_xml`](https://rubygems.org/gems/multi_xml)    |       |

| [FaradayMiddleware::ParseYaml](https://github.com/lostisland/faraday_middleware/blob/main/lib/faraday_middleware/response/parse_yaml.rb)  | [`safe_yaml`](https://rubygems.org/gems/safe_yaml)     | Not backwards compatible with versions of this middleware prior to `faraday_middleware` v0.12. See code comments for alternatives. |

| [FaradayMiddleware::Mashify](https://github.com/lostisland/faraday_middleware/blob/main/lib/faraday_middleware/response/mashify.rb)  | [`hashie`](https://rubygems.org/gems/hashie)       |       |

| [FaradayMiddleware::Rashify](https://github.com/lostisland/faraday_middleware/blob/main/lib/faraday_middleware/response/rashify.rb)  | [`rash_alt`](https://rubygems.org/gems/rash_alt)     | Make sure to uninstall original `rash` gem to avoid conflict. |

Examples

--------

``` rb

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

```

  [faraday]: https://github.com/lostisland/faraday#readme

  [docs]: https://github.com/lostisland/faraday_middleware/wiki