http 0.9.8 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 33850aa83bf574cc7c05572dd92bc190e198b6e4
-  data.tar.gz: 5b7a2359fc586d691b85e59921bec5d1bcfb5b1d
+  metadata.gz: 58370408adc111fae0f96e4541839c2a0722ccf5
+  data.tar.gz: f3f4ff7f0ba274d7f9c969db7f65d01b134f5711
 SHA512:
-  metadata.gz: cf74a760183582d0bedf897f870a39607e3f808e24a64e0e89084cb4d038884f7b5cc891cb0062859799d497d7089253ec09c997e8b5719c42c9563629951cb0
-  data.tar.gz: 8fd03c0819fb1dc1e41deef051b3f3039b6e41c11f15509e4f96234decaec95d2776491ef384d3a7cdbde4eb8c7b3dd85b149bf702d93b2c2cc2b14ae3230728
+  metadata.gz: 8c18ee7df2159660a8ff5909bdac66e61bcc8e598a1be9d5ae13f825cc704112c3a67aaef633396acd22ca395ac2762bc17b48faccf6472c27eb8c31b8e6cc16
+  data.tar.gz: bb8e776f129502b8aa1b63be4ee1f935b430a2e4db3f8e613ff96d03059af8137e3760a1a553e4f85a76679a8e7e894ef175e6bc792aa199c46aa053a74f5967

data/.rubocop.yml

@@ -24,7 +24,7 @@ Metrics/ModuleLength:
   Max: 120
 
 Metrics/ParameterLists:
-  Max: 3
+  Max: 5
   CountKeywordArgs: true
 
 Metrics/AbcSize:

data/.travis.yml

@@ -1,3 +1,4 @@
+sudo: false
 bundler_args: --without development doc
 env:
   global:

data/CHANGES.md

@@ -1,179 +1,229 @@
+## 1.0.0 (2015-12-25)
+
+* [#265](https://github.com/httprb/http/pull/265/):
+  Remove deprecations ([@tarcieri]):
+  - HTTP::Chainable#with_follow (use #follow)
+  - HTTP::Chainable#with, #with_headers (use #headers)
+  - HTTP::Chainable#auth(:basic, ...) (use #basic_auth)
+  - HTTP::Chainable#default_headers (use #default_options[:headers])
+  - HTTP::Headers#append (use #add)
+  - HTTP::Options#[] hash-like API deprecated in favor of explicit methods
+  - HTTP::Request#request_header (use #headline)
+  - HTTP::Response::STATUS_CODES (use HTTP::Status::REASONS)
+  - HTTP::Response::SYMBOL_TO_STATUS_CODE (no replacement)
+  - HTTP::Response#status_code (use #status or #code)
+  - HTTP::Response::Status#symbolize (use #to_sym)
+
+* [#269](https://github.com/httprb/http/pull/273/):
+  Close connection in case of error during request.
+  ([@ixti])
+
+* [#271](https://github.com/httprb/http/pull/273/):
+  High-level exception wrappers for low-level I/O errors.
+  ([@ixti])
+
+* [#273](https://github.com/httprb/http/pull/273/):
+  Add encoding option.
+  ([@connorhd])
+
+* [#275](https://github.com/httprb/http/pull/273/):
+  Support for disabling Nagle's algorithm with `HTTP.nodelay`.
+  ([@nerdrew])
+
+* [#276](https://github.com/httprb/http/pull/276)
+  Use Encoding::BINARY as the default encoding for HTTP::Response::Body.
+  ([@tarcieri])
+
+* [#278](https://github.com/httprb/http/pull/278)
+  Use an options hash for HTTP::Request initializer API.
+  ([@ixti])
+
+* [#279](https://github.com/httprb/http/pull/279)
+  Send headers and body in one write if possible.
+  This avoids a pathological case in Nagle's algorithm.
+  ([@tarcieri])
+
+* [#281](https://github.com/httprb/http/pull/281)
+  Remove legacy 'Http' constant alias to 'HTTP'.
+  ([@tarcieri])
+
 ## 0.9.8 (2015-09-29)
 
 * [#260](https://github.com/httprb/http/pull/258):
   Fixed global timeout persisting time left across requests when reusing connections.
-  ([@zanker][])
+  ([@zanker])
+
 
 ## 0.9.7 (2015-09-19)
 
 * [#258](https://github.com/httprb/http/pull/258):
   Unified strategy for handling exception-based and exceptionless non-blocking
-  I/O. Fixes SSL support on JRuby 9000. ([@tarcieri][])
+  I/O. Fixes SSL support on JRuby 9000. ([@tarcieri])
 
 
 ## 0.9.6 (2015-09-06)
 
 * [#254](https://github.com/httprb/http/pull/254):
   Removed use of an ActiveSupport specific method #present?
-  ([@tarcieri][])
+  ([@tarcieri])
 
 
 ## 0.9.5 (2015-09-06)
 
 * [#252](https://github.com/httprb/http/pull/252):
   Fixed infinite hang/timeout when a request contained more than ~16,363 bytes.
-  ([@zanker][])
+  ([@zanker])
 
 
 ## 0.9.4 (2015-08-26)
 
 * [#246](https://github.com/httprb/http/issues/246):
   Fixes regression when body streaming was failing on some URIs.
-  ([@zanker][])
+  ([@zanker])
 * [#243](https://github.com/httprb/http/issues/243):
-  Fixes require timeout statements. ([@ixti][])
+  Fixes require timeout statements. ([@ixti])
 
 
 ## 0.9.3 (2015-08-19)
 
 * [#246](https://github.com/httprb/http/issues/246):
-  Fixed request URI normalization. ([@ixti][])
+  Fixed request URI normalization. ([@ixti])
   - Avoids query component normalization
   - Omits fragment component in headline
 
 
 ## 0.9.2 (2015-08-18)
 
-* Fixed exceptionless NIO EOF handling. ([@zanker][])
+* Fixed exceptionless NIO EOF handling. ([@zanker])
 
 
 ## 0.9.1 (2015-08-14)
 
 * [#246](https://github.com/httprb/http/issues/246):
-  Fix params special-chars escaping. ([@ixti][])
+  Fix params special-chars escaping. ([@ixti])
 
 
 ## 0.9.0 (2015-07-23)
 
 * [#240](https://github.com/httprb/http/pull/240):
-  Support for caching removed. ([@tarcieri][])
+  Support for caching removed. ([@tarcieri])
 * JRuby 9000 compatibility
 
 
 ## 0.8.14 (2015-08-19)
 
-* Backport request URI normalization fixes from master. ([@ixti][])
+* Backport request URI normalization fixes from master. ([@ixti])
 
 
 ## 0.8.13 (2015-08-14)
 
-* Backport params special-chars escaping fix from `v0.9.1`. ([@ixti][])
+* Backport params special-chars escaping fix from `v0.9.1`. ([@ixti])
 
 
 ## 0.8.12 (2015-05-26)
 
-* Fix `HTTP.timeout` API (was loosing previously defined options). ([@ixti][])
+* Fix `HTTP.timeout` API (was loosing previously defined options). ([@ixti])
 
 
 ## 0.8.11 (2015-05-22)
 
 * [#229](https://github.com/httprb/http/pull/229):
-  SNI support for HTTPS connections. ([@tarcieri][])
+  SNI support for HTTPS connections. ([@tarcieri])
 * [#227](https://github.com/httprb/http/pull/227):
-  Use "http.rb" in the User-Agent string. ([@tarcieri][])
+  Use "http.rb" in the User-Agent string. ([@tarcieri])
 
 
 ## 0.8.10 (2015-05-14)
 
-* Fix cookie headers generation. ([@ixti][])
+* Fix cookie headers generation. ([@ixti])
 
 
 ## 0.8.9 (2015-05-11)
 
-* Add cookies support. ([@ixti][])
+* Add cookies support. ([@ixti])
 * [#219](https://github.com/httprb/http/pull/219):
-  Enforce stringified body encoding. ([@Connorhd][])
+  Enforce stringified body encoding. ([@Connorhd])
 
 
 ## 0.8.8 (2015-05-09)
 
 * [#217](https://github.com/httprb/http/issues/217):
-  Fix CONNECT header for proxies. ([@Connorhd][])
+  Fix CONNECT header for proxies. ([@Connorhd])
 
 
 ## 0.8.7 (2015-05-08)
 
-* Fix `HTTP.timeout` API with options only given. ([@ixti][])
+* Fix `HTTP.timeout` API with options only given. ([@ixti])
 
 
 ## 0.8.6 (2015-05-08)
 
 * [#215](https://github.com/httprb/http/pull/215):
-  Reset global timeouts after the request finishes. ([@zanker][])
+  Reset global timeouts after the request finishes. ([@zanker])
 
 
 ## 0.8.5 (2015-05-06)
 
 * [#205](https://github.com/httprb/http/issues/205):
-  Add simple timeouts configuration API. ([@ixti][])
-* Deprecate `Request#request_header`. Use `Request#headline` instead. ([@ixti][])
+  Add simple timeouts configuration API. ([@ixti])
+* Deprecate `Request#request_header`. Use `Request#headline` instead. ([@ixti])
 
 
 ## 0.8.4 (2015-04-23)
 
-* Deprecate `#default_headers` and `#default_headers=`. ([@ixti][])
+* Deprecate `#default_headers` and `#default_headers=`. ([@ixti])
 * [#207](https://github.com/httprb/http/issues/207):
-  Deprecate chainable methods with `with_` prefix. ([@ixti][])
+  Deprecate chainable methods with `with_` prefix. ([@ixti])
 * [#186](https://github.com/httprb/http/pull/186):
-  Add support of HTTPS connections through proxy. ([@Connorhd][])
+  Add support of HTTPS connections through proxy. ([@Connorhd])
 
 
 ## 0.8.3 (2015-04-07)
 
 * [#206](https://github.com/httprb/http/issues/206):
-  Fix request headline. ([@ixti][])
-* Remove deprecated `Request#__method__`. ([@ixti][])
+  Fix request headline. ([@ixti])
+* Remove deprecated `Request#__method__`. ([@ixti])
 
 
 ## 0.8.2 (2015-04-06)
 
 * [#203](https://github.com/httprb/http/issues/203):
-  Fix Celluloid::IO compatibility. ([@ixti][])
-* Cleanup obsolete code. ([@zanker][])
+  Fix Celluloid::IO compatibility. ([@ixti])
+* Cleanup obsolete code. ([@zanker])
 
 
 ## 0.8.1 (2015-04-02)
 
 * [#202](https://github.com/httprb/http/issues/202):
-  Add missing `require "resolv"`. ([@ixti][])
+  Add missing `require "resolv"`. ([@ixti])
 * [#200](https://github.com/httprb/http/issues/200),
   [#201](https://github.com/httprb/http/pull/201):
-  Add block-form `#persistent` calls. ([@ixti][])
+  Add block-form `#persistent` calls. ([@ixti])
 
 
 ## 0.8.0 (2015-04-01)
 
 * [#199](https://github.com/httprb/http/pull/199):
-  Properly handle WaitWritable for SSL. ([@zanker][])
+  Properly handle WaitWritable for SSL. ([@zanker])
 * [#197](https://github.com/httprb/http/pull/197):
-  Add support for non-ASCII URis. ([@ixti][])
+  Add support for non-ASCII URis. ([@ixti])
 * [#187](https://github.com/httprb/http/pull/187),
   [#194](https://github.com/httprb/http/pull/194),
   [#195](https://github.com/httprb/http/pull/195):
-  Add configurable connection timeouts. ([@zanker][])
+  Add configurable connection timeouts. ([@zanker])
 * [#179](https://github.com/httprb/http/pull/179):
-  Refactor requests redirect following logic. ([@ixti][])
-* Support for persistent HTTP connections ([@zanker][])
+  Refactor requests redirect following logic. ([@ixti])
+* Support for persistent HTTP connections ([@zanker])
 * [#77](https://github.com/httprb/http/issues/77),
   [#177](https://github.com/httprb/http/pull/177):
-  Add caching support. ([@Asmod4n][], [@pezra][])
+  Add caching support. ([@Asmod4n], [@pezra])
 * [#176](https://github.com/httprb/http/pull/176):
   Improve servers used in specs boot up. Issue was initially raised up
-  by [@olegkovalenko][]. ([@ixti][])
-* Reflect FormData rename changes (FormData -> HTTP::FormData). ([@ixti][])
+  by [@olegkovalenko]. ([@ixti])
+* Reflect FormData rename changes (FormData -> HTTP::FormData). ([@ixti])
 * [#173](https://github.com/httprb/http/pull/173):
   `HTTP::Headers` now raises `HTTP::InvalidHeaderNameError` in case of
-  (surprise) invalid HTTP header field name (e.g.`"Foo:Bar"`). ([@ixti][])
+  (surprise) invalid HTTP header field name (e.g.`"Foo:Bar"`). ([@ixti])
 
 
 ## 0.7.3 (2015-03-24)
@@ -181,7 +231,7 @@
 * SECURITY FIX: http.rb failed to call the `#post_connection_check` method on
   SSL connections. This method implements hostname verification, and without it
   `http.rb` was vulnerable to MitM attacks. The problem was corrected by calling
-  `#post_connection_check` (CVE-2015-1828) ([@zanker][])
+  `#post_connection_check` (CVE-2015-1828) ([@zanker])
 
 
 ## 0.7.2 (2015-03-02)
@@ -199,33 +249,33 @@
 
 * [#73](https://github.com/httprb/http/issues/73),
   [#167](https://github.com/httprb/http/pull/167):
-  Add support of multipart form data. ([@ixti][])
+  Add support of multipart form data. ([@ixti])
 * Fix URI path normalization: `https://github.com` -> `https://github.com/`.
-  ([@ixti][])
+  ([@ixti])
 * [#163](https://github.com/httprb/http/pull/163),
   [#166](https://github.com/httprb/http/pull/166),
   [#152](https://github.com/httprb/http/issues/152):
-  Fix handling of EOF which caused infinite loop. ([@mickm][], [@ixti][])
-* Drop Ruby 1.8.7 support. ([@ixti][])
+  Fix handling of EOF which caused infinite loop. ([@mickm], [@ixti])
+* Drop Ruby 1.8.7 support. ([@ixti])
 * [#150](https://github.com/httprb/http/issues/150):
-  Fix default Host header value. ([@ixti][])
-* Remove BearerToken authorization header. ([@ixti][])
+  Fix default Host header value. ([@ixti])
+* Remove BearerToken authorization header. ([@ixti])
 * `#auth` sugar now accepts only string value of Authorization header.
   Calling `#auth(:basic, opts)` is deprecated, use `#basic_auth(opts)` instead.
-  ([@ixti][])
-* Fix handling of chunked responses without Content-Length header. ([@ixti][])
+  ([@ixti])
+* Fix handling of chunked responses without Content-Length header. ([@ixti])
 * Remove `HTTP::Request#method` and deprecate `HTTP::Request#__method__`
-  ([@sferik][])
+  ([@sferik])
 * Deprecate `HTTP::Response::STATUS_CODES`,
-  use `HTTP::Response::Status::REASONS` instead ([@ixti][])
-* Deprecate `HTTP::Response::SYMBOL_TO_STATUS_CODE` ([@ixti][])
-* Deprecate `HTTP::Response#status_code` ([@ixti][])
-* `HTTP::Response#status` now returns `HTTP::Response::Status`. ([@ixti][])
+  use `HTTP::Response::Status::REASONS` instead ([@ixti])
+* Deprecate `HTTP::Response::SYMBOL_TO_STATUS_CODE` ([@ixti])
+* Deprecate `HTTP::Response#status_code` ([@ixti])
+* `HTTP::Response#status` now returns `HTTP::Response::Status`. ([@ixti])
 * `HTTP::Response#reason` and `HTTP::Response#code` are proxies them
-  to corresponding methods of `HTTP::Response#status` ([@ixti][])
+  to corresponding methods of `HTTP::Response#status` ([@ixti])
 * Rename `HTTP.with_follow` to `HTTP.follow` and mark former one as being
-  deprecated ([@ixti][])
-* Delegate `HTTP::Response#readpartial` to `HTTP::Response::Body` ([@ixti][])
+  deprecated ([@ixti])
+* Delegate `HTTP::Response#readpartial` to `HTTP::Response::Body` ([@ixti])
 
 
 ## 0.6.4 (2015-03-25)
@@ -233,57 +283,57 @@
 * SECURITY FIX: http.rb failed to call the `#post_connection_check` method on
   SSL connections. This method implements hostname verification, and without it
   `http.rb` was vulnerable to MitM attacks. The problem was corrected by calling
-  `#post_connection_check` (CVE-2015-1828) ([@zanker][], backported by [@nicoolas25][])
+  `#post_connection_check` (CVE-2015-1828) ([@zanker], backported by [@nicoolas25])
 
 
 ## 0.6.3 (2014-11-14)
 
 * [#166](https://github.com/httprb/http/pull/166):
-  Backported EOF fix from master branch. ([@ixti][])
+  Backported EOF fix from master branch. ([@ixti])
 
 
 ## 0.6.2 (2014-08-06)
 
 * [#150](https://github.com/httprb/http/issues/150):
-  Fix default Host header value. ([@ixti][])
-* Deprecate BearerToken authorization header. ([@ixti][])
-* Fix handling of chunked responses without Content-Length header. ([@ixti][])
+  Fix default Host header value. ([@ixti])
+* Deprecate BearerToken authorization header. ([@ixti])
+* Fix handling of chunked responses without Content-Length header. ([@ixti])
 * Rename `HTTP.with_follow` to `HTTP.follow` and mark former one as being
-  deprecated ([@ixti][])
+  deprecated ([@ixti])
 
 
 ## 0.6.1 (2014-05-07)
 
-* Fix request `Content-Length` calculation for Unicode ([@challengee][])
-* Add `Response#flush` ([@ixti][])
-* Fix `Response::Body#readpartial` default size ([@hannesg][], [@ixti][])
-* Add missing `CRLF` for chunked bodies ([@hannesg][])
-* Fix forgotten CGI require ([@ixti][])
-* Improve README ([@tarcieri][])
+* Fix request `Content-Length` calculation for Unicode ([@challengee])
+* Add `Response#flush` ([@ixti])
+* Fix `Response::Body#readpartial` default size ([@hannesg], [@ixti])
+* Add missing `CRLF` for chunked bodies ([@hannesg])
+* Fix forgotten CGI require ([@ixti])
+* Improve README ([@tarcieri])
 
 
 ## 0.6.0 (2014-04-04)
 
-* Rename `HTTP::Request#method` to `HTTP::Request#verb` ([@krainboltgreene][])
-* Add `HTTP::ResponseBody` class ([@tarcieri][])
-* Change API of response on `HTTP::Client.request` and "friends" (`#get`, `#post`, etc) ([@tarcieri][])
-* Add `HTTP::Response#readpartial` ([@tarcieri][])
-* Add `HTTP::Headers` class ([@ixti][])
-* Fix and improve following redirects ([@ixti][])
-* Add `HTTP::Request#redirect` ([@ixti][])
-* Add `HTTP::Response#content_type` ([@ixti][])
-* Add `HTTP::Response#mime_type` ([@ixti][])
-* Add `HTTP::Response#charset` ([@ixti][])
-* Improve error message upon invalid URI scheme ([@ixti][])
-* Consolidate errors under common `HTTP::Error` namespace ([@ixti][])
-* Add easy way of adding Authorization header ([@ixti][])
-* Fix proxy support ([@hundredwatt][])
-* Fix and improve query params handing ([@jwinter][])
-* Change API of custom MIME type parsers ([@ixti][])
-* Remove `HTTP::Chainable#with_response` ([@ixti][])
-* Remove `HTTP::Response::BodyDelegator` ([@ixti][])
-* Remove `HTTP::Response#parsed_body` ([@ixti][])
-* Bump up input buffer from 4K to 16K ([@tarcieri][])
+* Rename `HTTP::Request#method` to `HTTP::Request#verb` ([@krainboltgreene])
+* Add `HTTP::ResponseBody` class ([@tarcieri])
+* Change API of response on `HTTP::Client.request` and "friends" (`#get`, `#post`, etc) ([@tarcieri])
+* Add `HTTP::Response#readpartial` ([@tarcieri])
+* Add `HTTP::Headers` class ([@ixti])
+* Fix and improve following redirects ([@ixti])
+* Add `HTTP::Request#redirect` ([@ixti])
+* Add `HTTP::Response#content_type` ([@ixti])
+* Add `HTTP::Response#mime_type` ([@ixti])
+* Add `HTTP::Response#charset` ([@ixti])
+* Improve error message upon invalid URI scheme ([@ixti])
+* Consolidate errors under common `HTTP::Error` namespace ([@ixti])
+* Add easy way of adding Authorization header ([@ixti])
+* Fix proxy support ([@hundredwatt])
+* Fix and improve query params handing ([@jwinter])
+* Change API of custom MIME type parsers ([@ixti])
+* Remove `HTTP::Chainable#with_response` ([@ixti])
+* Remove `HTTP::Response::BodyDelegator` ([@ixti])
+* Remove `HTTP::Response#parsed_body` ([@ixti])
+* Bump up input buffer from 4K to 16K ([@tarcieri])
 
 ``` ruby
 # Main API change you will mention is that `request` method and it's
@@ -297,7 +347,7 @@ parsed_body = HTTP.get("http://example.com/users.json").parse
 # Second major change in API is work with request/response headers
 # It is now delegated to `HTTP::Headers` class, so you can check it's
 # documentation for details, here we will only outline main difference.
-# Duckface (`[]=`) does not appends headers anymore
+# Duckface (`=`) does not appends headers anymore
 
 request[:content_type] = "text/plain"
 request[:content_type] = "text/html"
@@ -329,7 +379,7 @@ end
 
 ## 0.5.1 (2014-05-27)
 
-* Backports redirector fixes from 0.6.0 ([@ixti][])
+* Backports redirector fixes from 0.6.0 ([@ixti])
 * EOL of 0.5.X branch.
 
 
@@ -398,3 +448,4 @@ end
 [@krainboltgreene]: https://github.com/krainboltgreene
 [@hundredwatt]: https://github.com/hundredwatt
 [@jwinter]: https://github.com/jwinter
+[@nerdrew]: https://github.com/nerdrew

data/Gemfile

@@ -20,11 +20,11 @@ end
 group :test do
   gem "backports"
   gem "coveralls"
-  gem "simplecov",    ">= 0.9"
-  gem "json",         ">= 1.8.1"
-  gem "rspec",        "~> 3.0"
+  gem "simplecov", ">= 0.9"
+  gem "json",      ">= 1.8.1"
+  gem "rubocop",   "=  0.35.1"
+  gem "rspec",     "~> 3.0"
   gem "rspec-its"
-  gem "rubocop"
   gem "yardstick"
   gem "certificate_authority"
 end

data/README.md

@@ -4,12 +4,13 @@
 [![Build Status](https://secure.travis-ci.org/httprb/http.svg?branch=master)](http://travis-ci.org/httprb/http)
 [![Code Climate](https://codeclimate.com/github/httprb/http.svg?branch=master)](https://codeclimate.com/github/httprb/http)
 [![Coverage Status](https://coveralls.io/repos/httprb/http/badge.svg?branch=master)](https://coveralls.io/r/httprb/http)
-
+[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/httprb/http/blob/master/LICENSE.txt)
 
 ## About
 
-http.rb is an easy-to-use client library for making requests from Ruby. It uses
-a simple method chaining system for building requests, similar to Python's [Requests].
+HTTP (The Gem! a.k.a. http.rb) is an easy-to-use client library for making requests
+from Ruby. It uses a simple method chaining system for building requests, similar to
+Python's [Requests].
 
 Under the hood, http.rb uses [http_parser.rb], a fast HTTP parsing native
 extension based on the Node.js parser and a Java port thereof. This library
@@ -55,6 +56,10 @@ Top three reasons:
 
 Benchmarks performed using excon's benchmarking tool
 
+DISCLAIMER: Most benchmarks you find in READMEs are crap,
+including this one. These are out-of-date. If you care about
+performance, benchmark for yourself for your own use cases!
+
 ## Help and Discussion
 
 If you need help or just want to talk about the http.rb,
@@ -276,30 +281,6 @@ HTTP.persistent('http://en.wikipedia.org') do |http|
 end
 ```
 
-### Celluloid::IO Support
-
-http.rb makes it simple to make multiple concurrent HTTP requests from a
-Celluloid::IO actor. Here's a parallel HTTP fetcher combining http.rb with
-Celluloid::IO:
-
-```ruby
-require "celluloid/io"
-require "http"
-
-class HttpFetcher
-  include Celluloid::IO
-
-  def fetch(url)
-    HTTP.get(url, socket_class: Celluloid::IO::TCPSocket)
-  end
-end
-```
-
-There's a little more to it, but that's the core idea!
-
-* [Full parallel HTTP fetcher example](https://github.com/httprb/http/wiki/Parallel-requests-with-Celluloid%3A%3AIO)
-* See also: [Celluloid::IO](https://github.com/celluloid/celluloid-io)
-
 ### Timeouts
 
 By default, HTTP does not timeout on a request. You can enable per operation

data/lib/http/chainable.rb

@@ -83,7 +83,10 @@ module HTTP
     #   @option options [Float] :write Write timeout
     #   @option options [Float] :connect Connect timeout
     def timeout(klass, options = {})
-      klass, options = :per_operation, klass if klass.is_a? Hash
+      if klass.is_a? Hash
+        options = klass
+        klass   = :per_operation
+      end
 
       klass = case klass.to_sym
               when :null          then HTTP::Timeout::Null
@@ -166,29 +169,22 @@ module HTTP
       branch default_options.with_follow opts
     end
 
-    # @deprecated will be removed in 1.0.0
-    # @see #follow
-    alias_method :with_follow, :follow
-
     # Make a request with the given headers
     # @param headers
     def headers(headers)
       branch default_options.with_headers(headers)
     end
 
-    # @deprecated will be removed in 1.0.0
-    # @see #headers
-    alias_method :with, :headers
-
-    # @deprecated will be removed in 1.0.0
-    # @see #headers
-    alias_method :with_headers, :headers
-
     # Make a request with the given cookies
     def cookies(cookies)
       branch default_options.with_cookies(cookies)
     end
 
+    # Force a specific encoding for response body
+    def encoding(encoding)
+      branch default_options.with_encoding(encoding)
+    end
+
     # Accept the given MIME type(s)
     # @param type
     def accept(type)
@@ -197,10 +193,7 @@ module HTTP
 
     # Make a request with the given Authorization header
     # @param [#to_s] value Authorization header value
-    def auth(value, opts = nil)
-      # shim for deprecated auth(:basic, opts).
-      # will be removed in 0.8.0
-      return basic_auth(opts) if :basic == value
+    def auth(value)
       headers Headers::AUTHORIZATION => value.to_s
     end
 
@@ -229,19 +222,9 @@ module HTTP
       @default_options = HTTP::Options.new(opts)
     end
 
-    # @deprecated Will be removed in 1.0.0; Use `#default_options#headers`
-    # Get headers of HTTP options
-    def default_headers
-      default_options.headers
-    end
-
-    # Set headers of HTTP options
-    # @deprecated Will be removed in 1.0.0; Use `#headers`
-    # @param headers
-    def default_headers=(headers)
-      @default_options = default_options.dup do |opts|
-        opts.headers = headers
-      end
+    # Set TCP_NODELAY on the socket
+    def nodelay
+      branch default_options.with_nodelay(true)
     end
 
     private