Contents

# OpenUriRedirections

This gem applies a patch to OpenURI to optionally allow redirections from HTTP to HTTPS, or from HTTPS to HTTP.

Here is the problem it tries to solve:

    $ irb
    1.9.2p320 :001 > require 'open-uri'
    => true 
    1.9.2p320 :002 > open('http://github.com')
    RuntimeError: redirection forbidden: http://github.com -> https://github.com/

And here is how you can use this patch to follow the redirections:

    $ irb
    1.9.2p320 :001 > require 'open-uri'
    => true 
    > require 'open_uri_redirections'
    => true 
    1.9.2p320 :002 > open('http://github.com', :allow_safe_redirections => true)
    => #<File:/var/folders/...>

The patch contained in this gem adds two options to `OpenURI#open`:

* `:allow_safe_redirections` When set to true, it will allow HTTP => HTTPS redirections.
* `:allow_unsafe_redirections` When set to true, it will allow HTTPS => HTTP redirections.

## Understand what you're doing

Before using this gem, read this:

### Original gist URL:
[https://gist.github.com/1271420](https://gist.github.com/1271420)

### Relevant issue:
[http://redmine.ruby-lang.org/issues/3719](http://redmine.ruby-lang.org/issues/3719)

### Source here:
[https://github.com/ruby/ruby/blob/trunk/lib/open-uri.rb](https://github.com/ruby/ruby/blob/trunk/lib/open-uri.rb)

Use it at your own risk!

## Installation

Add this line to your application's Gemfile:

    gem 'open_uri_redirections'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install open_uri_redirections

## Contributing

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
open_uri_redirections-0.0.1	README.md