mint_http 0.1.12 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d96c48d259517f6bb8012cf6e00600db417b48ebdb570bab246e4727f24707b7
-  data.tar.gz: a2b117a6ab762c733625d647aff7de509cc8a13a0679754dad16ed856290207d
+  metadata.gz: 7876c7512848424e65ae274b51518aafda63775252fdbfa1b1d80641137036f1
+  data.tar.gz: 358de110ee10df9e2ba006f9589c16ee659de0f1c902f3d07b12cfd684b7c21f
 SHA512:
-  metadata.gz: 1757883fb698f942f30f5f352229eee819733cde43961b9e82a35631d8bbc11e8cd2b690be4159194368200df3d521eba3b5ea847dadc5ddae953b270852219c
-  data.tar.gz: dad7ef02f77b7e0a8341216d6cc95f62a409a076c24e0a3bd6840e071208be9e1ceee52376aa6388d3bd4530ce4520659838b5b5acef590425a4974c59b0c444
+  metadata.gz: 2ce4427818dbf5ed767770e5307213dcc19f3fc9a510b1527679e94f418c3671236fc863ba140155b343d7f120a91c07092007b79821f60ad6312f66ecdfebb0
+  data.tar.gz: dce9c8920f2f4dfc25a41f3fa4680117ebf686cee000a0aeb1cf18424f24fcb54e439d4ab116eedf2776eb962fc297ba6505a501603a080b58983ea53adce55f

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 ## [Unreleased]
 
+## [1.0.1] - 2025-05-26
+
+- Add SSL min and max version support
+
+## [1.0.0] - 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 (1.0.1)
       base64
       json
       net-http
       openssl
+      resolv
       uri
 
 GEM
@@ -18,15 +19,20 @@ 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
   arm64-darwin-22
+  arm64-darwin-23
 
 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/net_http_factory.rb

@@ -65,6 +65,9 @@ class MintHttp::NetHttpFactory
     net_http.key = options[:key]
     net_http.verify_mode = options[:verify_mode]
     net_http.verify_hostname = options[:verify_hostname]
+    net_http.min_version = options[:min_version]
+    net_http.max_version = options[:max_version]
+    
 
     if OpenSSL::X509::Store === options[:ca]
       net_http.cert_store = options[:ca]

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
@@ -22,6 +23,8 @@ module MintHttp
     attr_reader :proxy_port
     attr_reader :ssl_verify_mode
     attr_reader :ssl_verify_hostname
+    attr_reader :ssl_min_version
+    attr_reader :ssl_max_version
 
     # Attributes only available when request is made
     attr_reader :method
@@ -47,6 +50,8 @@ module MintHttp
       @proxy_pass = nil
       @ssl_verify_mode = nil
       @ssl_verify_hostname = nil
+      @ssl_min_version = nil
+      @ssl_max_version = nil
 
       @logger = MintHttp.config.logger
       @filter_params_list = MintHttp.config.filter_params_list
@@ -88,6 +93,12 @@ module MintHttp
       self
     end
 
+    def ssl_version(min, max)
+      @ssl_min_version = min
+      @ssl_max_version = max
+      self
+    end
+
     def use_ca(ca)
       @ca = ca
       self
@@ -281,6 +292,7 @@ module MintHttp
         logger.log_end
         logger.log_error(error)
         logger.write_log
+
         raise error
       end
 
@@ -293,6 +305,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
@@ -387,6 +426,8 @@ module MintHttp
         proxy_pass: @proxy_pass,
         verify_mode: @ssl_verify_mode,
         verify_hostname: @ssl_verify_hostname,
+        min_version: @ssl_min_version,
+        max_version: @ssl_max_version,
       }
 
       [url, net_request, options]

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.1"
 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.1
 platform: ruby
 authors:
 - Ali Alhoshaiyan
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-10-13 00:00:00.000000000 Z
+date: 2025-05-26 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
@@ -132,7 +141,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: A small fluent HTTP client.

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