UPGRADE.md

Upgrade guide

0.5

Options

Fix the option names, because some were renamed. The errors should point you in the right direction:

Typhoeus.get("www.example.com", follow_location: true)
# Ethon::Errors::InvalidOption: The option: follow_location is invalid.
# Please try followlocation instead of follow_location.
# ... [Backtrace]

Typhoeus.get("www.example.com", followlocation: true).code
#=> 200

Headers

Response#headers returns a hash now and replaces Response#headers_hash, use Response#response_headers for the raw string:

Typhoeus.get("www.example.com", followlocation: true).headers
#=> {
#      "date"=>"Tue, 06 Nov 2012 09:07:27 GMT",
#      "server"=>"Apache/2.2.3 (CentOS)",
#      "last-modified"=>"Wed, 09 Feb 2011 17:13:15 GMT",
#      "vary"=>"Accept-Encoding",
#      "connection"=>"close",
#      "content-type"=>"text/html; charset=UTF-8"
#   }

Typhoeus.get("www.example.com", followlocation: true).response_headers
#=> "HTTP/1.0 302 Found\r\nLocation: http://www.iana.org/domains/example/ [...]"

Params vs body

Make sure every request sends proper params and body (especially POST/PUT). :params becomes url parameter and :body request body. Before params for POST was smashed into the body.

Configuration

Create a global configuration in case you want to turn on verbose, memoize or block_connection:

Typhoeus.configure do |config|
  config.verbose = true
  config.memoize = true
end

Docs

When in doubt, read the docs or the code.