rest-client 2.0.0.rc4-x86-mswin32 → 2.0.0-x86-mswin32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 54555b609f694d43c1a52f4a043ee6df6c68bf17
-  data.tar.gz: d3613ca55fb039c4624ef1538dc614d4b6b5002a
+  metadata.gz: af1e5a6298b95569f890b60bf3422e0ef5bc05cf
+  data.tar.gz: 3311792f7f45cce8df085042e797f51786a6bc9a
 SHA512:
-  metadata.gz: ef4c1eb54c3e8dce4f874465f63788342365338935963648545b2575b32ea03d50328758a98c6dae88b1c9d4e7ebb53e07b2183f8849d4cb519106fd7dddab4e
-  data.tar.gz: 385a9eff6d878a444571eae99675061cc48c1d2298e8424c1964e274c2418cb262581501a6005b1a6bb182010ddb27903933a5398a30b39ca064f6c24e992e52
+  metadata.gz: f02d6679180319385d5e3277ad20362efc423ce9e7502e4a05eeacded8e4a0e11130ed38181eef1600a6c81b48c3b0de7584e6e1166209a10bcbe5cc42612c69
+  data.tar.gz: 6cafffe7561f7dcaad6ffc239bc5048365683781171cafe5b00574b70775a0a9549c47e5deb88ca1f6ad65cf4e78afe6dea7221c9ea01208a688fd98a9be5a5a

data/README.md

@@ -45,6 +45,35 @@ There are also several development dependencies. It's recommended to use
 [bundler](http://bundler.io/) to manage these dependencies for hacking on
 rest-client.
 
+### Upgrading to rest-client 2.0 from 1.x
+
+Users are encouraged to upgrade to rest-client 2.0, which cleans up a number of
+API warts and wrinkles, making rest-client generally more useful. Usage is
+largely compatible, so many applications will be able to upgrade with no
+changes.
+
+Overview of significant changes:
+
+* requires Ruby >= 2.0
+* `RestClient::Response` objects are a subclass of `String` rather than a
+  Frankenstein monster. And `#body` or `#to_s` return a true `String` object.
+* cleanup of exception classes, including new `RestClient::Exceptions::Timeout`
+* improvements to handling of redirects: responses and history are properly
+  exposed
+* major changes to cookie support: cookie jars are used for browser-like
+  behavior throughout
+* encoding: Content-Type charset response headers are used to automatically set
+  the encoding of the response string
+* HTTP params: handling of GET/POST params is more consistent and sophisticated
+  for deeply nested hash objects, and `ParamsArray` can be used to pass ordered
+  params
+* improved proxy support with per-request proxy configuration, plus the ability
+  to disable proxies set by environment variables
+* default request headers: rest-client sets `Accept: */*` and
+  `User-Agent: rest-client/...`
+
+See [history.md](./history.md) for a more complete description of changes.
+
 ## Usage: Raw URL
 ```ruby
 require 'rest-client'
@@ -177,10 +206,38 @@ end
 ➔ 404 Resource Not Found | text/html 282 bytes
 ```
 
-### Manually following redirection
+### Redirection
+
+By default, rest-client will follow HTTP 30x redirection requests.
+
+__New in 2.0:__ `RestClient::Response` exposes a `#history` method that returns
+a list of each response received in a redirection chain.
+
+```ruby
+>> r = RestClient.get('http://httpbin.org/redirect/2')
+=> <RestClient::Response 200 "{\n  \"args\":...">
+
+# see each response in the redirect chain
+>> r.history
+=> [<RestClient::Response 302 "<!DOCTYPE H...">, <RestClient::Response 302 "">]
+
+# see each requested URL
+>> r.request.url
+=> "http://httpbin.org/get"
+>> r.history.map {|x| x.request.url}
+=> ["http://httpbin.org/redirect/2", "http://httpbin.org/relative-redirect/1"]
+```
+
+#### Manually following redirection
 
 To disable automatic redirection, set `:max_redirects => 0`.
 
+__New in 2.0:__ Prior versions of rest-client would raise
+`RestClient::MaxRedirectsReached`, with no easy way to access the server's
+response. In 2.0, rest-client raises the normal
+`RestClient::ExceptionWithResponse` as it would with any other non-HTTP-20x
+response.
+
 ```ruby
 >> RestClient::Request.execute(method: :get, url: 'http://httpbin.org/redirect/1')
 => RestClient::Response 200 "{\n  "args":..."
@@ -226,7 +283,7 @@ Response objects have several useful methods. (See the class rdoc for more detai
 - `Response#cookies`: A hash of HTTP cookies set by the server
 - `Response#cookie_jar`: <em>New in 1.8</em> An HTTP::CookieJar of cookies
 - `Response#request`: The RestClient::Request object used to make the request
-- `Response#history`: If redirection was followed, a list of prior Response objects
+- `Response#history`: <em>New in 2.0</em> If redirection was followed, a list of prior Response objects
 
 ```ruby
 RestClient.get('http://example.com')

data/lib/restclient/request.rb

@@ -59,6 +59,10 @@ module RestClient
     #
     # This list will be used by default if the Ruby global OpenSSL default
     # ciphers appear to be a weak list.
+    #
+    # TODO: either remove this code or always use it, since Ruby uses a decent
+    # cipher list in versions >= 2.0.
+    #
     DefaultCiphers = %w{
       !aNULL
       !eNULL

data/lib/restclient/utils.rb

@@ -8,8 +8,8 @@ module RestClient
     # text. This differs from the older RFC 2616 behavior, which specifies
     # using ISO-8859-1 for text/* content types without a charset.
     #
-    # Strings will effectively end up using `Encoding.default_external` when
-    # this method returns nil.
+    # Strings will use the default encoding when this method returns nil. This
+    # default is likely to be UTF-8 for Ruby >= 2.0
     #
     # @param headers [Hash<Symbol,String>]
     #

data/lib/restclient/version.rb

@@ -1,5 +1,5 @@
 module RestClient
-  VERSION_INFO = [2, 0, 0, 'rc4'] unless defined?(self::VERSION_INFO)
+  VERSION_INFO = [2, 0, 0] unless defined?(self::VERSION_INFO)
   VERSION = VERSION_INFO.map(&:to_s).join('.') unless defined?(self::VERSION)
 
   def self.version

data/spec/integration/integration_spec.rb

@@ -88,14 +88,15 @@ describe RestClient do
       expect(response.encode('utf-8')).to eq body_utf8
     end
 
-    it 'defaults to Encoding.default_external' do
+    it 'defaults to the default encoding' do
       stub_request(:get, 'www.example.com').to_return(
         body: 'abc', status: 200, headers: {
           'Content-Type' => 'text/plain'
         })
 
       response = RestClient.get 'www.example.com'
-      expect(response.encoding).to eq Encoding.default_external
+      # expect(response.encoding).to eq Encoding.default_external
+      expect(response.encoding).to eq Encoding::UTF_8
     end
 
     it 'handles invalid encoding' do
@@ -105,7 +106,8 @@ describe RestClient do
         })
 
       response = RestClient.get 'www.example.com'
-      expect(response.encoding).to eq Encoding.default_external
+      # expect(response.encoding).to eq Encoding.default_external
+      expect(response.encoding).to eq Encoding::UTF_8
     end
 
     it 'leaves images as binary' do

data/spec/unit/request_spec.rb

@@ -567,7 +567,8 @@ describe RestClient::Request, :include_helpers do
       allow(ENV).to receive(:[]).with("http_proxy").and_return("http://127.0.0.1")
       allow(ENV).to receive(:[]).with("no_proxy").and_return(nil)
       allow(ENV).to receive(:[]).with("NO_PROXY").and_return(nil)
-      allow(ENV).to receive(:[]).with("NETRC").and_return(nil)
+      allow(Netrc).to receive(:read).and_return({})
+
       req = RestClient::Request.new(:method => :put, :url => 'http://some/resource', :payload => 'payload')
       obj = req.net_http_object('host', 80)
       expect(obj.proxy?).to be true

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rest-client
 version: !ruby/object:Gem::Version
-  version: 2.0.0.rc4
+  version: 2.0.0
 platform: x86-mswin32
 authors:
 - REST Client Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-06-19 00:00:00.000000000 Z
+date: 2016-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: webmock
@@ -253,9 +253,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.4.5.1