Faraday Follow Redirects

Faraday middleware to follow HTTP redirects transparently.

Important

This is a Faraday 2.x compatible extraction of the deprecated FaradayMiddleware::FollowRedirects (v1.2.0). This gem will also work with Faraday 1.x on a best-effort basis, but keep in mind that Faraday 1.x itself is no longer getting any updates or support! Please update to Faraday 2.x as soon as possible!

We only support non-EOL versions of Ruby. See Ruby Maintenance Branches for the list of non-EOL Rubies.

Installation

Add this line to your application's Gemfile:

gem 'faraday-follow_redirects'

And then execute:

bundle install

Or install it yourself as:

gem install faraday-follow_redirects

Usage

require 'faraday/follow_redirects'

Faraday.new(url: url) do |faraday|
  faraday.response :follow_redirects # use Faraday::FollowRedirects::Middleware
  faraday.adapter Faraday.default_adapter
end

Upgrading from Faraday 1.x

If you still use Faraday 1.x, and have uninstalled the faraday_middleware gem, all you have to change is:

- conn.use FaradayMiddleware::FollowRedirects
+ conn.use Faraday::FollowRedirects::Middleware

Development

After checking out the repo, run bin/setup to install dependencies.

Then, run bin/test to run the tests.

To install this gem onto your local machine, run rake build.

To release a new version, make a commit with a message such as "Bumped to 0.0.2" and then run rake release. See how it works here.

The .ruby-version file defines the default version to be used for development.

Appraisal for testing multiple versions of dependencies

We use appraisal to test against both faraday 1.x and 2.x, and ./bin/test will run tests against both. To run tests against just one you could:

bundle exec appraisal faraday_1 rspec
bundle exec appraisal faraday_2 rspec

Contributing

Bug reports and pull requests are welcome on GitHub.

License

The gem is available as open source under the terms of the MIT License.