mint_http 0.1.12 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d96c48d259517f6bb8012cf6e00600db417b48ebdb570bab246e4727f24707b7
-  data.tar.gz: a2b117a6ab762c733625d647aff7de509cc8a13a0679754dad16ed856290207d
+  metadata.gz: e9e732a985585fb708b2ed2c520fe271224c121cae660000c59e948fa341e21c
+  data.tar.gz: 00fc67f3613bac4feff07b5e659dc7b6712e5efa75a378a63692bc22534b1b54
 SHA512:
-  metadata.gz: 1757883fb698f942f30f5f352229eee819733cde43961b9e82a35631d8bbc11e8cd2b690be4159194368200df3d521eba3b5ea847dadc5ddae953b270852219c
-  data.tar.gz: dad7ef02f77b7e0a8341216d6cc95f62a409a076c24e0a3bd6840e071208be9e1ceee52376aa6388d3bd4530ce4520659838b5b5acef590425a4974c59b0c444
+  metadata.gz: 4c36fa3817748e4ec1fc4b1c5ff3e640a5bd39a21dec8c2322d92557a24d9384ebac9f7cd7713f37637c58def3af9534d9111af3f384a546ef1ea0d2147b5d8e
+  data.tar.gz: 21376671680cbb833dd922e5f6cdbd4fd6cfd87c6ba036eb0701fd89df0cccc52e428981dd28c869793586e1d8d308b0fc3e32e6d9660c23ac2e1312dd8daad2

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
+## [0.1.12] - 2024-11-05
+
+- Improve error handling by introducing new error base class that makes it easy for users to catch and deal with errors.
+- Add more HTTP error classes.
+
+
+## [0.1.12] - 2024-10-13
+
+- Fix Logging when server returns a UTF-8 response with invalid encoding set in header
+
+
 ## [0.1.0] - 2023-07-03
 
 - Initial release

data/Gemfile

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in mint_http.gemspec
 gemspec
 
-gem "rake", "~> 13.0"
-
-gem "minitest", "~> 5.0"
+gem 'rake', '~> 13.0'
+gem 'minitest', '~> 5.0'
+gem 'resolv-replace'

data/Gemfile.lock

@@ -1,11 +1,12 @@
 PATH
   remote: .
   specs:
-    mint_http (0.1.8)
+    mint_http (0.1.12)
       base64
       json
       net-http
       openssl
+      resolv
       uri
 
 GEM
@@ -18,6 +19,9 @@ GEM
       uri
     openssl (3.2.0)
     rake (13.0.6)
+    resolv (0.4.0)
+    resolv-replace (0.1.1)
+      resolv
     uri (0.13.0)
 
 PLATFORMS
@@ -27,6 +31,7 @@ DEPENDENCIES
   minitest (~> 5.0)
   mint_http!
   rake (~> 13.0)
+  resolv-replace
 
 BUNDLED WITH
-   2.3.16
+   2.5.6

data/lib/mint_http/errors.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module MintHttp
+  class Error < StandardError; end
+
+  # Errno::EHOSTUNREACH: The network host is unreachable, often due to network configuration issues or connectivity problems.
+  # ENETUNREACH
+  class ConnectionError < Error; end
+
+  # Errno::ECONNREFUSED: The connection was refused by the remote server, often because the port is closed or the server is not running.
+  class ConnectionRefusedError < ConnectionError; end
+
+  # Errno::ECONNRESET: The connection was reset by the peer (the other end of the connection), typically due to abrupt disconnection.
+  class ConnectionResetError < ConnectionError; end
+
+  # Errno::ECONNABORTED: The connection was aborted, often due to the network or the other side abruptly closing the connection.
+  class ConnectionAbortedError < ConnectionError; end
+
+  # IOError
+  # EOFError: Raised when an end-of-file condition is reached, often indicating that the connection was closed by the peer during reading.
+  # Errno::EPIPE: Writing to a closed socket results in this error, indicating a "broken pipe."
+  # Errno::EIO: Input/output error, typically indicating an issue with reading or writing to the socket due to a system-level error.
+  class ConnectionIoError < ConnectionError; end
+
+  # DNS Errors
+  # SocketError: getaddrinfo
+  # Resolv::ResolvError
+  # Resolv::ResolvTimeout
+  class NameResolutionError < ConnectionError; end
+
+  # SSL Error
+  # OpenSSL::SSL::SSLError
+  class ConnectionSslError < ConnectionError; end
+
+  class TimeoutError < Error; end
+  class ReadTimeoutError < TimeoutError; end
+  class WriteTimeoutError < TimeoutError; end
+  class OpenTimeoutError < TimeoutError; end
+
+  class ResponseError < Error
+    # @return [HTTP::Response]
+    attr_reader :response
+
+    def initialize(msg, response)
+      super(msg)
+      @response = response
+    end
+
+    def to_s
+      response.inspect
+    end
+  end
+
+  class ServerError < ResponseError; end
+  class BadGatewayError < ServerError; end
+  class ServiceUnavailableError < ServerError; end
+  class GatewayTimeoutError < ServerError; end
+
+
+  class ClientError < ResponseError; end
+  class NotFoundError < ClientError; end
+  class AuthenticationError < ClientError; end
+  class AuthorizationError < ClientError; end
+end

data/lib/mint_http/request.rb

@@ -5,6 +5,7 @@ require 'net/http'
 require 'uri'
 require 'openssl'
 require 'json'
+require 'resolv'
 
 module MintHttp
   class Request
@@ -281,6 +282,7 @@ module MintHttp
         logger.log_end
         logger.log_error(error)
         logger.write_log
+
         raise error
       end
 
@@ -293,6 +295,33 @@ module MintHttp
       logger.write_log
 
       response
+
+    rescue SocketError => e
+      if e.message.include?('getaddrinfo') || e.cause.is_a?(Resolv::ResolvError) || e.cause.is_a?(Resolv::ResolvTimeout)
+        raise NameResolutionError, e.message
+      else
+        raise ConnectionIoError, e.message
+      end
+
+    rescue Net::OpenTimeout => e
+      raise OpenTimeoutError, e.message
+    rescue Net::WriteTimeout => e
+      raise WriteTimeoutError, e.message
+    rescue Net::ReadTimeout => e
+      raise ReadTimeoutError, e.message
+
+    rescue Errno::ECONNREFUSED => e
+      raise ConnectionRefusedError, e.message
+    rescue Errno::ECONNRESET => e
+      raise ConnectionResetError, e.message
+
+    rescue IOError, EOFError, Errno::EPIPE, Errno::EIO => e
+      raise ConnectionIoError, e.message
+    rescue Errno::EHOSTUNREACH, Errno::ENETUNREACH => e
+      raise ConnectionError, e.message
+
+    rescue OpenSSL::SSL::SSLError => e
+      raise ConnectionSslError, e.message
     end
 
     private

data/lib/mint_http/response.rb

@@ -85,6 +85,12 @@ module MintHttp
           raise AuthorizationError.new('Forbidden', self)
         when 404
           raise NotFoundError.new('Not Found', self)
+        when 502
+          raise BadGatewayError.new('Bad Gateway', self)
+        when 503
+          raise ServiceUnavailableError.new('Service Unavailable', self)
+        when 504
+          raise GatewayTimeoutError.new('Gateway Timeout', self)
         when 400..499
           raise ClientError.new('Client Error', self)
         when 500..599

data/lib/mint_http/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MintHttp
-  VERSION = "0.1.12"
+  VERSION = "1.0.0"
 end

data/lib/mint_http.rb

@@ -7,12 +7,7 @@ require_relative 'mint_http/config'
 require_relative 'mint_http/pool_entry'
 require_relative 'mint_http/pool'
 require_relative 'mint_http/headers'
-require_relative 'mint_http/errors/response_error'
-require_relative 'mint_http/errors/server_error'
-require_relative 'mint_http/errors/client_error'
-require_relative 'mint_http/errors/authorization_error'
-require_relative 'mint_http/errors/authentication_error'
-require_relative 'mint_http/errors/not_found_error'
+require_relative 'mint_http/errors'
 require_relative 'mint_http/net_http_factory'
 require_relative 'mint_http/request_logger'
 require_relative 'mint_http/response'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mint_http
 version: !ruby/object:Gem::Version
-  version: 0.1.12
+  version: 1.0.0
 platform: ruby
 authors:
 - Ali Alhoshaiyan
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-10-13 00:00:00.000000000 Z
+date: 2024-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -80,6 +80,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: resolv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Like a mint breeze, MintHttp allows you to write simple HTTP requests
   while giving you the full power of Net::HTTP.
 email:
@@ -96,12 +110,7 @@ files:
 - Rakefile
 - lib/mint_http.rb
 - lib/mint_http/config.rb
-- lib/mint_http/errors/authentication_error.rb
-- lib/mint_http/errors/authorization_error.rb
-- lib/mint_http/errors/client_error.rb
-- lib/mint_http/errors/not_found_error.rb
-- lib/mint_http/errors/response_error.rb
-- lib/mint_http/errors/server_error.rb
+- lib/mint_http/errors.rb
 - lib/mint_http/headers.rb
 - lib/mint_http/net_http_factory.rb
 - lib/mint_http/pool.rb

data/lib/mint_http/errors/authentication_error.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-class MintHttp::AuthenticationError < MintHttp::ClientError
-end

data/lib/mint_http/errors/authorization_error.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-class MintHttp::AuthorizationError < MintHttp::ClientError
-end

data/lib/mint_http/errors/client_error.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-class MintHttp::ClientError < MintHttp::ResponseError
-end

data/lib/mint_http/errors/not_found_error.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-class MintHttp::NotFoundError < MintHttp::ClientError
-end

data/lib/mint_http/errors/response_error.rb

@@ -1,15 +0,0 @@
-# frozen_string_literal: true
-
-class MintHttp::ResponseError < StandardError
-  # @return [HTTP::Response]
-  attr_reader :response
-
-  def initialize(msg, response)
-    super(msg)
-    @response = response
-  end
-
-  def to_s
-    response.inspect
-  end
-end

data/lib/mint_http/errors/server_error.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-class MintHttp::ServerError < MintHttp::ResponseError
-end