mint_http 0.1.11 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13d0c6552e8bbf4b2d407cfb63f912116332c050ef55ff2b40249e357eaf50b2
-  data.tar.gz: bb5ed66026c77894f50c1cb4f399e5cb6c4636213105ee2d6cd041c3718ab36c
+  metadata.gz: e9e732a985585fb708b2ed2c520fe271224c121cae660000c59e948fa341e21c
+  data.tar.gz: 00fc67f3613bac4feff07b5e659dc7b6712e5efa75a378a63692bc22534b1b54
 SHA512:
-  metadata.gz: c77b61d61e1268f799c2bfaf57d14fbea69255156c6b4b05c77df50df19bf188e4145134158a20876bbdea37a337a649fbd1253a3ff9c502a47e63b52219e63f
-  data.tar.gz: 101e27c0c4fcf208ce2eb80dbba3a5fa4d998937cf57db20d61ed76a94c4e8c0fc8ab42096c8f6d535bc1bba7b95990a895a8b5c308958dab4767b9333d3f1b9
+  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/request_logger.rb

@@ -109,7 +109,7 @@ module MintHttp
 
       @logger.info(buffer.strip)
     rescue Encoding::CompatibilityError => e
-      logger.logger.warn(e)
+      @logger.warn(e)
     end
 
     def log_connection_info(http)

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.11"
+  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.11
+  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