http-client 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6bd3c5c6c67b68ab191ee00c5dcdcb75b5a4549e
-  data.tar.gz: 5bbbcb5bab7c3bedf0b670f73b836803437e89c3
+  metadata.gz: 442016d7995b5d8e1e31886a4aaff8a34102635d
+  data.tar.gz: f7bc4ab873d2cc41abccecac5b4d46c148e88d78
 SHA512:
-  metadata.gz: aba36be8c66578583270f7cd2e71f105a37a8c5af8d6cb3585c35795af02a6be32f39d51178bbdb53d35922389ea6fd6ea2874b33dbe3f27e8b31e43772b7413
-  data.tar.gz: 05e2370d9f6c65885ef2adc18087e209a35dceebe44b567b737821903b882233c5e79342297b97665116a7e462e01f8ceab2d60a4b0fb083a616b226ca45e7d3
+  metadata.gz: 9347691549ccb5381f277597a198fd6042b3cfa3c6b3b0eafcf0f539cfd3ca7be6a6d5d7f36590d46099cbd98602757ff936754c0e3a3986dfe45085da216ca1
+  data.tar.gz: dfe32ba2b0e52035fe0572023fc34a914cc6b518cd00b746cd8779f895fa718b771094c37a51b29dd2ba0f268a6662090af82d4aaa0586b3c9634e65006e9523

data/CHANGELOG

@@ -1,3 +1,7 @@
+== 0.3.0 (2017-06-30
+
+* Rescue error conditions and re-raise them as HTTP::Client::Error sub-classes.
+
 == 0.2.2 (2016-09-21)
 
 * URI parser error for relative paths.

data/README.md

@@ -45,6 +45,19 @@ HTTP::Client::Response
     #last_effective_uri
 ```
 
+### Exceptions
+
+HTTP::Client rescues most Net::HTTP, Zlib and URI related exceptions and re-raises them as an appropriate exception.
+You can retrieve the original exception using the `HTTP::Client::Error#original_error` instance method.
+
+```
+HTTP::Client::Error
+  HTTP::Client::Error::URI
+  HTTP::Client::Error::Zlib
+  HTTP::Client::Error::Timeout
+  HTTP::Client::Error::Transport
+```
+
 ### Request parameters
 
 #### Required

data/lib/http/client.rb

@@ -9,7 +9,7 @@ require 'zlib'
 
 module HTTP
   module Client
-    VERSION = '0.2.2'
+    VERSION = '0.3.0'
 
     GET                     = Net::HTTP::Get
     HEAD                    = Net::HTTP::Head
@@ -201,7 +201,7 @@ module HTTP
         end
 
         def request! uri, delegate
-          http = Net::HTTP.new(uri.host, uri.port)
+          http = Net::HTTP.new(uri.host, uri.port, :ENV)
           if uri.scheme == 'https'
             http.use_ssl     = true
             http.verify_mode = @ssl_verify
@@ -214,6 +214,14 @@ module HTTP
           response = http.request(delegate)
           http.finish if http.started?
           response
+        rescue URI::Error => e
+          raise Error::URI.new(e.message, e)
+        rescue Zlib::Error => e
+          raise Error::Zlib.new(e.message, e)
+        rescue Timeout::Error => e
+          raise Error::Timeout.new(e.message, e)
+        rescue Net::HTTPBadResponse, Net::HTTPHeaderSyntaxError, Net::ProtocolError => e
+          raise Error::Transport.new(e.message, e)
         end
 
         def redirect_to uri, code
@@ -418,5 +426,19 @@ module HTTP
       #
       def trace uri, args = {}; Request.new(TRACE, uri, args).execute; end
     end
+
+    class Error < StandardError
+      attr_reader :original_error
+
+      def initialize message, original_error = nil
+        @original_error = original_error
+        super(message)
+      end
+
+      class URI < Error; end
+      class Zlib < Error; end
+      class Timeout < Error; end
+      class Transport < Error; end
+    end # Error
   end # Client
 end # HTTP

data/test/test_request.rb

@@ -47,7 +47,7 @@ describe 'HTTP Client Request' do
     app    = proc {|req| sleep }
     server = TestServer.new(app)
     server.run
-    assert_raises(Net::ReadTimeout) {HTTP::Client.get(server.root, timeout: 0.2)}
+    assert_raises(HTTP::Client::Error::Timeout) {HTTP::Client.get(server.root, timeout: 0.2)}
   end
 
   it 'handles redirects' do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: http-client
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Bharanee Rathna
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-09-21 00:00:00.000000000 Z
+date: 2017-06-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mime-types
@@ -124,7 +124,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
 summary: A client wrapper around Net::HTTP