net-hippie 1.3.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 998433769957af723da2f4803acd93083a124bbefb5af0bf95a5083a0afae59c
-  data.tar.gz: 45b2708548b30020c6a74f269669545ed3355d4c567a914763313dd516f35afd
+  metadata.gz: f1f315d747c0e48d92a0a25bb9395fe80f472757782d8341b43f833462f5338e
+  data.tar.gz: d71b266d4e60f3ca16f6eed02c0ac2d42b10ab6c60a445a2c349351b75bad4f8
 SHA512:
-  metadata.gz: bd3c51b47e5bc632c105daf5aa589cc1df70952ea2b7baa05c699b63e5a54b74054f19d4d42f2715d9d0339a7b28a55e17714e087fa6a385689b158426f6f0bf
-  data.tar.gz: b7374b67ac0bcf7f93a0ac9715e5fe8cd517e614dcdd06cdf924bb61ca76c4f222b802e9b3cf3dd5a735c78ac5f076f3db13128ef59c510e826c1748d19c72c0
+  metadata.gz: 524460bd6fd5a982db5025418ebb9449cfee70876df3338230f06eb97fdf2bedae4c591d987b3c06fca7f363355d6acf96ceecaf9c3299915eacecd578a5a5d6
+  data.tar.gz: 7b885d2bcdb7298bad431ad2fdf51a67b7fd356caa0cc01ff8557cbf85bc7e9eb575e655e95789f53795a5f8acd16c3b98c25b2d831ec9410a5a8d5e03aa6c8d

data/.rubocop.yml

@@ -1,3 +1,7 @@
+plugins:
+  - rubocop-minitest
+  - rubocop-rake
+
 AllCops:
   Exclude:
     - 'coverage/**/*'
@@ -6,7 +10,7 @@ AllCops:
     - 'tmp/**/*'
     - 'vendor/**/*'
   NewCops: enable
-  TargetRubyVersion: 3.2
+  TargetRubyVersion: 4.0
 
 Gemspec/DevelopmentDependencies:
   EnforcedStyle: gemspec

data/CHANGELOG.md

@@ -1,5 +1,3 @@
-Version 1.3.0
-
 # Changelog
 All notable changes to this project will be documented in this file.
 
@@ -8,6 +6,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.5.0] - 2026-02-01
+
+### Changed
+
+- Prefer IPv4 addresses in DNS resolution to avoid connectivity issues
+- Increase default `keep_alive_timeout` to 30 seconds for better connection reuse
+- Set TLS `min_version` to TLS 1.2 by default for improved security
+- Improve retry logging format with structured error details
+
+### Added
+
+- Add thread-safe connection pooling with LRU eviction
+- Add DNS pre-resolution with configurable timeout to prevent indefinite hangs
+- Add DNS caching with TTL support
+- Add persistent HTTP sessions to avoid `Connection: close` overhead
+- Add `head` and `options` HTTP methods
+- Add `close_all` method to release all pooled connections
+- Add `reset_default_client!` method to reset the default client
+- Add configuration options: `keep_alive_timeout`, `max_retries`, `min_version`, `continue_timeout`, `ignore_eof`, `max_connections`, `dns_timeout`, `dns_ttl`
+- Parse TLS certificates once at initialization for performance
+
+### Fixed
+
+- Fix connection leak when racing threads create duplicate connections
+
+## [1.4.0] - 2025-10-08
+### Added
+- Streaming response support via block parameter
+- Backward compatible with existing block API (arity-based detection)
+
 ## [1.3.0] - 2025-04-30
 ### Changed
 - Ruby 2.3+ required
@@ -95,30 +123,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - with\_retry.
 - authorization header helpers
 
-[Unreleased]: https://github.com/xlgmokha/net-hippie/compare/v1.3.0...HEAD
-[1.3.0]: https://github.com/xlgmokha/net-hippie/compare/v1.2.0...v1.3.0
-[1.2.0]: https://github.com/xlgmokha/net-hippie/compare/v1.1.1...v1.2.0
-[1.1.1]: https://github.com/xlgmokha/net-hippie/compare/v1.1.0...v1.1.1
-[1.1.0]: https://github.com/xlgmokha/net-hippie/compare/v1.0.1...v1.1.0
-[1.0.1]: https://github.com/xlgmokha/net-hippie/compare/v1.0.0...v1.0.1
-[1.0.0]: https://github.com/xlgmokha/net-hippie/compare/v0.3.2...v1.0.0
-[0.3.2]: https://github.com/xlgmokha/net-hippie/compare/v0.3.1...v0.3.2
-[0.3.1]: https://github.com/xlgmokha/net-hippie/compare/v0.3.0...v0.3.1
-[0.3.0]: https://github.com/xlgmokha/net-hippie/compare/v0.2.7...v0.3.0
-[0.2.7]: https://github.com/xlgmokha/net-hippie/compare/v0.2.6...v0.2.7
-[0.2.6]: https://github.com/xlgmokha/net-hippie/compare/v0.2.5...v0.2.6
-[0.2.5]: https://github.com/xlgmokha/net-hippie/compare/v0.2.4...v0.2.5
-[0.2.4]: https://github.com/xlgmokha/net-hippie/compare/v0.2.3...v0.2.4
-[0.2.3]: https://github.com/xlgmokha/net-hippie/compare/v0.2.2...v0.2.3
-[0.2.2]: https://github.com/xlgmokha/net-hippie/compare/v0.2.1...v0.2.2
-[0.2.1]: https://github.com/xlgmokha/net-hippie/compare/v0.2.0...v0.2.1
-[0.2.0]: https://github.com/xlgmokha/net-hippie/compare/v0.1.9...v0.2.0
-[0.1.9]: https://github.com/xlgmokha/net-hippie/compare/v0.1.8...v0.1.9
-[0.1.8]: https://github.com/xlgmokha/net-hippie/compare/v0.1.7...v0.1.8
-[0.1.7]: https://github.com/xlgmokha/net-hippie/compare/v0.1.6...v0.1.7
-[0.1.6]: https://github.com/xlgmokha/net-hippie/compare/v0.1.5...v0.1.6
-[0.1.5]: https://github.com/xlgmokha/net-hippie/compare/v0.1.4...v0.1.5
-[0.1.4]: https://github.com/xlgmokha/net-hippie/compare/v0.1.3...v0.1.4
-[0.1.3]: https://github.com/xlgmokha/net-hippie/compare/v0.1.2...v0.1.3
-[0.1.2]: https://github.com/xlgmokha/net-hippie/compare/v0.1.1...v0.1.2
-[0.1.1]: https://github.com/xlgmokha/net-hippie/compare/v0.1.0...v0.1.1
+[Unreleased]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v1.5.0...HEAD
+[1.5.0]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v1.4.0...v1.5.0
+[1.4.0]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v1.3.0...v1.4.0
+[1.3.0]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v1.2.0...v1.3.0
+[1.2.0]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v1.1.1...v1.2.0
+[1.1.1]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v1.1.0...v1.1.1
+[1.1.0]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v1.0.1...v1.1.0
+[1.0.1]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v1.0.0...v1.0.1
+[1.0.0]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.3.2...v1.0.0
+[0.3.2]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.3.1...v0.3.2
+[0.3.1]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.3.0...v0.3.1
+[0.3.0]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.2.7...v0.3.0
+[0.2.7]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.2.6...v0.2.7
+[0.2.6]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.2.5...v0.2.6
+[0.2.5]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.2.4...v0.2.5
+[0.2.4]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.2.3...v0.2.4
+[0.2.3]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.2.2...v0.2.3
+[0.2.2]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.2.1...v0.2.2
+[0.2.1]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.2.0...v0.2.1
+[0.2.0]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.1.9...v0.2.0
+[0.1.9]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.1.8...v0.1.9
+[0.1.8]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.1.7...v0.1.8
+[0.1.7]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.1.6...v0.1.7
+[0.1.6]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.1.5...v0.1.6
+[0.1.5]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.1.4...v0.1.5
+[0.1.4]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.1.3...v0.1.4
+[0.1.3]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.1.2...v0.1.3
+[0.1.2]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.1.1...v0.1.2
+[0.1.1]: https://src.mokhan.ca/xlgmokha/net-hippie/compare/v0.1.0...v0.1.1

data/README.md

@@ -1,9 +1,5 @@
 # Net::Hippie
 
-[![Gem Version](https://badge.fury.io/rb/net-hippie.svg)](https://rubygems.org/gems/net-hippie)
-[![Build Status](https://github.com/xlgmokha/net-hippie/actions/workflows/ci.yml/badge.svg))](https://github.com/xlgmokha/net-hippie/actions)
-
-
 `Net::Hippie` is a light weight wrapper around `net/http` that defaults to
 sending `JSON` messages.
 
@@ -90,6 +86,40 @@ headers = { 'Authorization' => Net::Hippie.bearer_auth('token') }
 Net::Hippie.get('https://www.example.org', headers: headers)
 ```
 
+### Streaming Responses
+
+Net::Hippie supports streaming responses by passing a block that accepts the response object:
+
+```ruby
+Net::Hippie.post('https://api.example.com/stream', body: { prompt: 'Hello' }) do |response|
+  response.read_body do |chunk|
+    print chunk
+  end
+end
+```
+
+This is useful for Server-Sent Events (SSE) or other streaming APIs:
+
+```ruby
+client = Net::Hippie::Client.new
+client.post('https://api.openai.com/v1/chat/completions',
+  headers: {
+    'Authorization' => Net::Hippie.bearer_auth(ENV['OPENAI_API_KEY']),
+    'Content-Type' => 'application/json'
+  },
+  body: { model: 'gpt-4', messages: [{ role: 'user', content: 'Hi' }], stream: true }
+) do |response|
+  buffer = ""
+  response.read_body do |chunk|
+    buffer += chunk
+    while (line = buffer.slice!(/.*\n/))
+      next if line.strip.empty?
+      puts line if line.start_with?('data: ')
+    end
+  end
+end
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/test` to run the tests.
@@ -102,7 +132,7 @@ push git commits and tags, and push the `.gem` file to [rubygems.org](https://ru
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/xlgmokha/net-hippie.
+Patches are welcome at https://src.mokhan.ca/xlgmokha/net-hippie.
 
 ## License
 

data/lib/net/hippie/client.rb

@@ -1,15 +1,22 @@
 # frozen_string_literal: true
 
+require 'net/hippie/dns_cache'
+require 'net/hippie/tls_parser'
+
 module Net
   module Hippie
-    # A simple client for connecting with http resources.
+    # HTTP client with connection pooling, DNS caching, and retry logic.
     class Client
+      include TlsParser
+
       DEFAULT_HEADERS = {
         'Accept' => 'application/json',
         'Content-Type' => 'application/json',
-        'User-Agent' => "net/hippie #{Net::Hippie::VERSION}"
+        'User-Agent' => "net/hippie #{VERSION}"
       }.freeze
 
+      JITTER = Random.new.freeze
+
       attr_reader :mapper, :logger, :follow_redirects
 
       def initialize(options = {})
@@ -17,92 +24,103 @@ module Net
         @mapper = options.fetch(:mapper, ContentTypeMapper.new)
         @logger = options.fetch(:logger, Net::Hippie.logger)
         @follow_redirects = options.fetch(:follow_redirects, 0)
-        @default_headers = options.fetch(:headers, DEFAULT_HEADERS)
-        @connections = Hash.new do |hash, key|
-          scheme, host, port = key
-          hash[key] = Connection.new(scheme, host, port, options)
-        end
+        @default_headers = options.fetch(:headers, DEFAULT_HEADERS).freeze
+        configure_pool(options)
+        configure_tls(options)
       end
 
-      def execute(uri, request, limit: follow_redirects, &block)
-        connection = connection_for(uri)
-        response = connection.run(request)
-        if limit.positive? && response.is_a?(Net::HTTPRedirection)
-          url = connection.build_url_for(response['location'])
-          request = request_for(Net::HTTP::Get, url)
-          execute(url, request, limit: limit - 1, &block)
-        else
-          block_given? ? yield(request, response) : response
+      %i[get post put patch delete].each do |method|
+        define_method(method) do |uri, headers: {}, body: {}, stream: false, &block|
+          run(uri, Net::HTTP.const_get(method.capitalize), headers, body, stream, &block)
         end
       end
 
-      def get(uri, headers: {}, body: {}, &block)
-        run(uri, Net::HTTP::Get, headers, body, &block)
-      end
-
-      def patch(uri, headers: {}, body: {}, &block)
-        run(uri, Net::HTTP::Patch, headers, body, &block)
+      %i[head options].each do |method|
+        define_method(method) do |uri, headers: {}, &block|
+          run(uri, Net::HTTP.const_get(method.capitalize), headers, {}, false, &block)
+        end
       end
 
-      def post(uri, headers: {}, body: {}, &block)
-        run(uri, Net::HTTP::Post, headers, body, &block)
-      end
+      def execute(uri, request, limit: follow_redirects, stream: false, &block)
+        conn = connection_for(uri)
+        return conn.run(request) { |res| res.read_body(&block) } if stream && block
 
-      def put(uri, headers: {}, body: {}, &block)
-        run(uri, Net::HTTP::Put, headers, body, &block)
-      end
+        return execute_with_block(conn, request, &block) if block
 
-      def delete(uri, headers: {}, body: {}, &block)
-        run(uri, Net::HTTP::Delete, headers, body, &block)
+        response = conn.run(request)
+        limit.positive? && response.is_a?(Net::HTTPRedirection) ? follow_redirect(uri, response, limit) : response
       end
 
-      # attempt 1 -> delay 0.1 second
-      # attempt 2 -> delay 0.2 second
-      # attempt 3 -> delay 0.4 second
-      # attempt 4 -> delay 0.8 second
-      # attempt 5 -> delay 1.6 second
-      # attempt 6 -> delay 3.2 second
-      # attempt 7 -> delay 6.4 second
-      # attempt 8 -> delay 12.8 second
       def with_retry(retries: 3)
-        retries = 0 if retries.nil? || retries.negative?
+        retries = [retries.to_i, 0].max
+        0.upto(retries) do |attempt|
+          return yield self
+        rescue *CONNECTION_ERRORS => error
+          raise if attempt == retries
 
-        0.upto(retries) do |n|
-          attempt(n, retries) do
-            return yield self
-          end
+          sleep_with_backoff(attempt, retries, error)
         end
       end
 
+      def close_all
+        @pool.close_all
+        @dns_cache.clear
+      end
+
       private
 
-      attr_reader :default_headers
+      def configure_pool(options)
+        @dns_ttl = options.fetch(:dns_ttl, 300)
+        @dns_cache = DnsCache.new(
+          timeout: options.fetch(:dns_timeout, 5), ttl: @dns_ttl, logger: @logger
+        )
+        @pool = ConnectionPool.new(max_size: options.fetch(:max_connections, 100), dns_ttl: @dns_ttl)
+      end
 
-      def attempt(attempt, max)
-        yield
-      rescue *CONNECTION_ERRORS => error
-        raise error if attempt == max
+      def configure_tls(options)
+        @tls_cert = parse_cert(options[:certificate])
+        @tls_key = parse_key(options[:key], options[:passphrase])
+        @continue_timeout = options[:continue_timeout]
+        @ignore_eof = options.fetch(:ignore_eof, true)
+      end
 
-        delay = ((2**attempt) * 0.1) + Random.rand(0.05) # delay + jitter
-        logger&.warn("`#{error.message}` #{attempt + 1}/#{max} Delay: #{delay}s")
-        sleep delay
+      def run(uri, method, headers, body, stream, &block)
+        uri = URI.parse(uri.to_s) unless uri.is_a?(URI::Generic)
+        execute(uri, build_request(method, uri, headers, body), stream: stream, &block)
       end
 
-      def request_for(type, uri, headers: {}, body: {})
-        final_headers = default_headers.merge(headers)
-        type.new(URI.parse(uri.to_s), final_headers).tap do |x|
-          x.body = mapper.map_from(final_headers, body) unless body.empty?
-        end
+      def build_request(type, uri, headers, body)
+        merged = headers.empty? ? @default_headers : @default_headers.merge(headers)
+        path = uri.respond_to?(:request_uri) ? uri.request_uri : uri.path
+        type.new(path, merged).tap { |req| req.body = @mapper.map_from(merged, body) unless body.empty? }
       end
 
-      def run(uri, http_method, headers, body, &block)
-        request = request_for(http_method, uri, headers: headers, body: body)
-        execute(uri, request, &block)
+      def execute_with_block(conn, request, &block)
+        block.arity == 2 ? yield(request, conn.run(request)) : conn.run(request, &block)
       end
 
       def connection_for(uri)
-        uri = URI.parse(uri.to_s)
-        @connections[[uri.scheme, uri.host, uri.port]]
+        uri = URI.parse(uri.to_s) unless uri.is_a?(URI::Generic)
+        key = [uri.scheme, uri.host, uri.port]
+        @pool.checkout(key) { Connection.new(uri.scheme, uri.host, uri.port, @dns_cache.resolve(uri.host), conn_opts) }
+      end
+
+      def sleep_with_backoff(attempt, max_retries, error)
+        delay = ((2**attempt) * 0.1) + JITTER.rand(0.05)
+        logger&.warn("[Hippie] #{error.class}: #{error.message} | Retry #{attempt + 1}/#{max_retries}")
+        sleep delay
+      end
+
+      def conn_opts
+        @options.merge(
+          tls_cert: @tls_cert, tls_key: @tls_key,
+          continue_timeout: @continue_timeout, ignore_eof: @ignore_eof
+        )
+      end
+
+      def follow_redirect(original_uri, response, limit)
+        redirect_uri = original_uri.merge(response['location'])
+        execute(redirect_uri, build_request(Net::HTTP::Get, redirect_uri, {}, {}), limit: limit - 1)
       end
     end
   end

data/lib/net/hippie/connection.rb

@@ -2,21 +2,31 @@
 
 module Net
   module Hippie
-    # A connection to a specific host
+    # Persistent HTTP connection with automatic reconnection.
     class Connection
-      def initialize(scheme, host, port, options = {})
-        http = Net::HTTP.new(host, port)
-        http.read_timeout = options.fetch(:read_timeout, 10)
-        http.open_timeout = options.fetch(:open_timeout, 10)
-        http.use_ssl = scheme == 'https'
-        http.verify_mode = options.fetch(:verify_mode, Net::Hippie.verify_mode)
-        http.set_debug_output(options[:logger]) if options[:logger]
-        apply_client_tls_to(http, options)
-        @http = http
+      RETRYABLE_ERRORS = [EOFError, Errno::ECONNABORTED, Errno::ECONNRESET, Errno::EPIPE, IOError].freeze
+
+      def initialize(scheme, host, port, ipaddr, options = {})
+        @mutex = Mutex.new
+        @created_at = Time.now
+        @http = build_http(scheme, host, port, ipaddr, options)
       end
 
-      def run(request)
-        @http.request(request)
+      def run(request, &block)
+        @mutex.synchronize do
+          ensure_started
+          execute(request, &block)
+        end
+      end
+
+      def stale?(ttl)
+        (Time.now - @created_at) > ttl
+      end
+
+      def close
+        @mutex.synchronize { @http.finish if @http.started? }
+      rescue IOError
+        nil
       end
 
       def build_url_for(path)
@@ -27,15 +37,51 @@ module Net
 
       private
 
-      def apply_client_tls_to(http, options)
-        return if options[:certificate].nil? || options[:key].nil?
+      def build_http(scheme, host, port, ipaddr, options)
+        Net::HTTP.new(host, port).tap do |http|
+          configure_timeouts(http, options)
+          configure_ssl(http, scheme, options)
+          configure_tls_client(http, options)
+          http.ipaddr = ipaddr if ipaddr
+        end
+      end
+
+      def configure_timeouts(http, options)
+        http.open_timeout = options.fetch(:open_timeout, 10)
+        http.read_timeout = options.fetch(:read_timeout, 10)
+        http.write_timeout = options.fetch(:write_timeout, 10)
+        http.keep_alive_timeout = options.fetch(:keep_alive_timeout, 30)
+        http.max_retries = options.fetch(:max_retries, 1)
+        http.continue_timeout = options[:continue_timeout] if options[:continue_timeout]
+        http.ignore_eof = options.fetch(:ignore_eof, true)
+      end
+
+      def configure_ssl(http, scheme, options)
+        http.use_ssl = scheme == 'https'
+        return unless http.use_ssl?
+
+        http.min_version = options.fetch(:min_version, :TLS1_2)
+        http.verify_mode = options.fetch(:verify_mode, Net::Hippie.verify_mode)
+        http.set_debug_output(options[:logger]) if options[:logger]
+      end
 
-        http.cert = OpenSSL::X509::Certificate.new(options[:certificate])
-        http.key = private_key(options[:key], options[:passphrase])
+      def configure_tls_client(http, options)
+        http.cert = options[:tls_cert] if options[:tls_cert]
+        http.key = options[:tls_key] if options[:tls_key]
       end
 
-      def private_key(key, passphrase, type = OpenSSL::PKey::RSA)
-        passphrase ? type.new(key, passphrase) : type.new(key)
+      def ensure_started
+        @http.start unless @http.started?
+      end
+
+      def execute(request, retried: false, &block)
+        block ? @http.request(request, &block) : @http.request(request)
+      rescue *RETRYABLE_ERRORS
+        raise if retried
+
+        @http.finish if @http.started?
+        @http.start
+        execute(request, retried: true, &block)
       end
     end
   end

data/lib/net/hippie/connection_pool.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Net
+  module Hippie
+    # Thread-safe connection pool with LRU eviction.
+    class ConnectionPool
+      def initialize(max_size: 100, dns_ttl: 300)
+        @max_size = max_size
+        @dns_ttl = dns_ttl
+        @connections = {}
+        @monitor = Monitor.new
+      end
+
+      def checkout(key, &block)
+        reuse(key) || create(key, &block)
+      end
+
+      def close_all
+        @monitor.synchronize do
+          @connections.each_value(&:close)
+          @connections.clear
+        end
+      end
+
+      private
+
+      def reuse(key)
+        @monitor.synchronize do
+          return nil unless @connections.key?(key)
+
+          conn = @connections.delete(key)
+          return @connections[key] = conn unless conn.stale?(@dns_ttl)
+
+          conn.close
+          nil
+        end
+      end
+
+      def create(key)
+        conn = yield
+        @monitor.synchronize do
+          existing = reuse(key)
+          if existing
+            conn.close
+            return existing
+          end
+          evict_lru if @connections.size >= @max_size
+          @connections[key] = conn
+        end
+      end
+
+      def evict_lru
+        key, conn = @connections.first
+        conn.close
+        @connections.delete(key)
+      end
+    end
+  end
+end

data/lib/net/hippie/dns_cache.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Net
+  module Hippie
+    # Thread-safe DNS resolution cache with TTL.
+    class DnsCache
+      def initialize(timeout: 5, ttl: 300, logger: nil)
+        @timeout = timeout
+        @ttl = ttl
+        @logger = logger
+        @cache = {}
+        @monitor = Monitor.new
+      end
+
+      def resolve(hostname)
+        cached = get(hostname)
+        return cached if cached
+
+        ip = Net::Hippie.resolve(hostname, timeout: @timeout)
+        set(hostname, ip)
+        ip
+      rescue Timeout::Error, Resolv::ResolvError => error
+        @logger&.warn("[Hippie] DNS resolution failed for #{hostname}: #{error.message}")
+        nil
+      end
+
+      def clear
+        @monitor.synchronize { @cache.clear }
+      end
+
+      private
+
+      def get(hostname)
+        @monitor.synchronize do
+          entry = @cache[hostname]
+          entry[:ip] if entry && (Time.now - entry[:time]) < @ttl
+        end
+      end
+
+      def set(hostname, ip_addr)
+        @monitor.synchronize { @cache[hostname] = { ip: ip_addr, time: Time.now } }
+      end
+    end
+  end
+end

data/lib/net/hippie/tls_parser.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Net
+  module Hippie
+    # Parses TLS certificates and keys from various formats.
+    module TlsParser
+      def parse_cert(cert)
+        return cert if cert.is_a?(OpenSSL::X509::Certificate) || cert.nil?
+
+        OpenSSL::X509::Certificate.new(cert)
+      end
+
+      def parse_key(key, passphrase)
+        return key if key.is_a?(OpenSSL::PKey::PKey) || key.nil?
+
+        passphrase ? OpenSSL::PKey::RSA.new(key, passphrase) : OpenSSL::PKey::RSA.new(key)
+      end
+    end
+  end
+end

data/lib/net/hippie/version.rb

@@ -2,6 +2,6 @@
 
 module Net
   module Hippie
-    VERSION = '1.3.0'
+    VERSION = '1.5.0'
   end
 end

data/lib/net/hippie.rb

@@ -3,69 +3,83 @@
 require 'base64'
 require 'json'
 require 'logger'
+require 'monitor'
 require 'net/http'
 require 'openssl'
+require 'resolv'
+require 'timeout'
 
-require 'net/hippie/version'
 require 'net/hippie/client'
 require 'net/hippie/connection'
+require 'net/hippie/connection_pool'
 require 'net/hippie/content_type_mapper'
+require 'net/hippie/version'
 
 module Net
-  # net/http for hippies.
+  # High-performance HTTP client with connection pooling and DNS caching.
   module Hippie
     CONNECTION_ERRORS = [
       EOFError,
       Errno::ECONNREFUSED,
       Errno::ECONNRESET,
-      Errno::ECONNRESET,
       Errno::EHOSTUNREACH,
       Errno::EINVAL,
+      Errno::EPIPE,
+      Errno::ECONNABORTED,
+      Errno::ETIMEDOUT,
+      IOError,
       Net::OpenTimeout,
       Net::ProtocolError,
       Net::ReadTimeout,
+      Net::WriteTimeout,
       OpenSSL::OpenSSLError,
       OpenSSL::SSL::SSLError,
       SocketError,
       Timeout::Error
     ].freeze
 
-    def self.logger
-      @logger ||= Logger.new(nil)
-    end
+    BASIC_PREFIX = 'Basic '
+    BEARER_PREFIX = 'Bearer '
 
-    def self.logger=(logger)
-      @logger = logger
-    end
+    class << self
+      attr_writer :logger, :verify_mode
 
-    def self.verify_mode
-      @verify_mode ||= OpenSSL::SSL::VERIFY_PEER
-    end
+      def logger
+        @logger ||= Logger.new(nil)
+      end
 
-    def self.verify_mode=(mode)
-      @verify_mode = mode
-    end
+      def verify_mode
+        @verify_mode ||= OpenSSL::SSL::VERIFY_PEER
+      end
 
-    def self.basic_auth(username, password)
-      "Basic #{::Base64.strict_encode64("#{username}:#{password}")}"
-    end
+      def basic_auth(username, password)
+        BASIC_PREFIX + ::Base64.strict_encode64("#{username}:#{password}")
+      end
 
-    def self.bearer_auth(token)
-      "Bearer #{token}"
-    end
+      def bearer_auth(token)
+        BEARER_PREFIX + token
+      end
 
-    def self.method_missing(symbol, *args)
-      default_client.with_retry(retries: 3) do |client|
-        client.public_send(symbol, *args)
-      end || super
-    end
+      def default_client
+        @default_client ||= Client.new(follow_redirects: 3, logger: logger)
+      end
 
-    def self.respond_to_missing?(name, _include_private = false)
-      Client.public_instance_methods.include?(name.to_sym) || super
-    end
+      def reset_default_client!
+        @default_client = nil
+      end
+
+      %i[get post put patch delete head options].each do |method|
+        define_method(method) do |*args, **kwargs, &block|
+          default_client.with_retry(retries: 3) { |c| c.public_send(method, *args, **kwargs, &block) }
+        end
+      end
 
-    def self.default_client
-      @default_client ||= Client.new(follow_redirects: 3, logger: logger)
+      def resolve(hostname, timeout: 5)
+        Timeout.timeout(timeout) do
+          addresses = Resolv.getaddresses(hostname)
+          addresses.find { |a| a.match?(/^\d+\.\d+\.\d+\.\d+$/) } || addresses.first
+        end
+      end
     end
   end
 end

data/net-hippie.gemspec

@@ -7,17 +7,18 @@ require 'net/hippie/version'
 Gem::Specification.new do |spec|
   spec.name          = 'net-hippie'
   spec.version       = Net::Hippie::VERSION
-  spec.authors       = ['mo']
+  spec.authors       = ['mo khan']
   spec.email         = ['mo@mokhan.ca']
 
   spec.summary       = 'net/http for hippies. ☮️ '
   spec.description   = 'net/http for hippies. ☮️ '
-  spec.homepage      = 'https://rubygems.org/gems/net-hippie'
+  spec.homepage      = 'https://src.mokhan.ca/xlgmokha/net-hippie'
   spec.license       = 'MIT'
-  spec.metadata      = {
-    'source_code_uri' => 'https://github.com/xlgmokha/net-hippie',
-    'rubygems_mfa_required' => 'true'
-  }
+  spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://git.mokhan.ca/xlgmokha/net-hippie.git'
+  spec.metadata['changelog_uri'] = 'https://src.mokhan.ca/xlgmokha/net-hippie/blob/main/CHANGELOG.md.html'
+  spec.metadata['rubygems_mfa_required'] = 'true'
 
   spec.files = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})
@@ -25,16 +26,21 @@ Gem::Specification.new do |spec|
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
-  spec.required_ruby_version = Gem::Requirement.new('>= 3.2.0')
+  spec.required_ruby_version = Gem::Requirement.new('>= 4.0.0')
 
   spec.add_dependency 'base64', '~> 0.1'
   spec.add_dependency 'json', '~> 2.0'
   spec.add_dependency 'logger', '~> 1.0'
-  spec.add_dependency 'net-http', '~> 0.6'
-  spec.add_dependency 'openssl', '~> 3.0'
-  spec.add_development_dependency 'minitest', '~> 5.0'
+  spec.add_dependency 'monitor', '~> 0.1'
+  spec.add_dependency 'net-http', '~> 0.1'
+  spec.add_dependency 'openssl', '~> 4.0'
+  spec.add_dependency 'resolv', '~> 0.1'
+  spec.add_dependency 'timeout', '~> 0.1'
+  spec.add_development_dependency 'minitest', '~> 6.0'
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rubocop', '~> 1.9'
+  spec.add_development_dependency 'rubocop-minitest', '~> 0.1'
+  spec.add_development_dependency 'rubocop-rake', '~> 0.1'
   spec.add_development_dependency 'vcr', '~> 6.0'
   spec.add_development_dependency 'webmock', '~> 3.4'
 end

data/sig/net/hippie/client.rbs

@@ -0,0 +1,25 @@
+module Net
+  module Hippie
+    class Client
+      DEFAULT_HEADERS: Hash[String, String]
+
+      attr_reader mapper: ContentTypeMapper
+      attr_reader logger: untyped
+      attr_reader follow_redirects: Integer
+
+      def initialize: (?Hash[Symbol, untyped] options) -> void
+
+      def get: (untyped uri, ?headers: Hash[String, String], ?body: untyped, ?stream: bool) ?{ (untyped) -> void } -> untyped
+      def post: (untyped uri, ?headers: Hash[String, String], ?body: untyped, ?stream: bool) ?{ (untyped) -> void } -> untyped
+      def put: (untyped uri, ?headers: Hash[String, String], ?body: untyped, ?stream: bool) ?{ (untyped) -> void } -> untyped
+      def patch: (untyped uri, ?headers: Hash[String, String], ?body: untyped, ?stream: bool) ?{ (untyped) -> void } -> untyped
+      def delete: (untyped uri, ?headers: Hash[String, String], ?body: untyped, ?stream: bool) ?{ (untyped) -> void } -> untyped
+      def head: (untyped uri, ?headers: Hash[String, String]) ?{ (untyped) -> void } -> untyped
+      def options: (untyped uri, ?headers: Hash[String, String]) ?{ (untyped) -> void } -> untyped
+
+      def execute: (untyped uri, untyped request, ?limit: Integer, ?stream: bool) ?{ (untyped) -> void } -> untyped
+      def with_retry: (?retries: Integer) { (Client) -> untyped } -> untyped
+      def close_all: () -> void
+    end
+  end
+end

data/sig/net/hippie/content_type_mapper.rbs

@@ -0,0 +1,7 @@
+module Net
+  module Hippie
+    class ContentTypeMapper
+      def map_from: (Hash[String, String] headers, (Hash[untyped, untyped] | String) body) -> (String | Hash[untyped, untyped])
+    end
+  end
+end

data/sig/net/hippie.rbs

@@ -0,0 +1,29 @@
+module Net
+  module Hippie
+    VERSION: String
+
+    CONNECTION_ERRORS: Array[Class]
+
+    def self.logger: () -> untyped
+    def self.logger=: (untyped) -> untyped
+
+    def self.verify_mode: () -> Integer
+    def self.verify_mode=: (Integer) -> Integer
+
+    def self.basic_auth: (String username, String password) -> String
+    def self.bearer_auth: (String token) -> String
+
+    def self.default_client: () -> Client
+    def self.reset_default_client!: () -> nil
+
+    def self.resolve: (String hostname, ?timeout: Integer) -> String?
+
+    def self.get: (untyped uri, ?headers: Hash[String, String], ?body: untyped, ?stream: bool) ?{ (untyped) -> void } -> untyped
+    def self.post: (untyped uri, ?headers: Hash[String, String], ?body: untyped, ?stream: bool) ?{ (untyped) -> void } -> untyped
+    def self.put: (untyped uri, ?headers: Hash[String, String], ?body: untyped, ?stream: bool) ?{ (untyped) -> void } -> untyped
+    def self.patch: (untyped uri, ?headers: Hash[String, String], ?body: untyped, ?stream: bool) ?{ (untyped) -> void } -> untyped
+    def self.delete: (untyped uri, ?headers: Hash[String, String], ?body: untyped, ?stream: bool) ?{ (untyped) -> void } -> untyped
+    def self.head: (untyped uri, ?headers: Hash[String, String]) ?{ (untyped) -> void } -> untyped
+    def self.options: (untyped uri, ?headers: Hash[String, String]) ?{ (untyped) -> void } -> untyped
+  end
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: net-hippie
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.5.0
 platform: ruby
 authors:
-- mo
+- mo khan
 bindir: exe
 cert_chain: []
-date: 2025-04-30 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -51,48 +51,90 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: monitor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: net-http
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: openssl
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: resolv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: timeout
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '6.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -121,6 +163,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: rubocop-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: vcr
   requirement: !ruby/object:Gem::Requirement
@@ -157,8 +227,6 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/dependabot.yml"
-- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rubocop.yml"
 - CHANGELOG.md
@@ -175,14 +243,23 @@ files:
 - lib/net/hippie.rb
 - lib/net/hippie/client.rb
 - lib/net/hippie/connection.rb
+- lib/net/hippie/connection_pool.rb
 - lib/net/hippie/content_type_mapper.rb
+- lib/net/hippie/dns_cache.rb
+- lib/net/hippie/tls_parser.rb
 - lib/net/hippie/version.rb
 - net-hippie.gemspec
-homepage: https://rubygems.org/gems/net-hippie
+- sig/net/hippie.rbs
+- sig/net/hippie/client.rbs
+- sig/net/hippie/content_type_mapper.rbs
+homepage: https://src.mokhan.ca/xlgmokha/net-hippie
 licenses:
 - MIT
 metadata:
-  source_code_uri: https://github.com/xlgmokha/net-hippie
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://src.mokhan.ca/xlgmokha/net-hippie
+  source_code_uri: https://git.mokhan.ca/xlgmokha/net-hippie.git
+  changelog_uri: https://src.mokhan.ca/xlgmokha/net-hippie/blob/main/CHANGELOG.md.html
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
@@ -191,14 +268,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: 4.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.6
+rubygems_version: 4.0.5
 specification_version: 4
 summary: net/http for hippies. ☮️
 test_files: []

data/.github/dependabot.yml

@@ -1,9 +0,0 @@
----
-version: 2
-updates:
-  - package-ecosystem: "bundler"
-    directory: "/"
-    schedule:
-      interval: "daily"
-    assignees:
-      - "xlgmokha"

data/.github/workflows/ci.yml

@@ -1,31 +0,0 @@
-name: ci
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        ruby-version: ['3.2', '3.3', '3.4']
-    steps:
-      - uses: actions/checkout@v2
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: ${{ matrix.ruby-version }}
-          bundler-cache: true
-      - name: Running tests…
-        run: sh bin/test
-  style:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: '3.4'
-          bundler-cache: true
-      - name: Running style checks…
-        run: sh bin/style