philiprehberger-http_client 0.8.0 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0c2d06598cd67b2eacacb8b5782991c53204d9d2d0975161e8a342f02b6ea9ea
-  data.tar.gz: 65df219a10eff45bdd84e202dc74336881c979f0cedcfb33855118e519b0d0d9
+  metadata.gz: ad967beaec9e64b19f5f3ff422942f5d74af63c347eec2e4b7fa61b1038d5eea
+  data.tar.gz: 5d16323e87ea653e03069fbf53800840b9f6a0bef8c6dc939fa9ec8a1ec3d54e
 SHA512:
-  metadata.gz: e4b987d048b25358a516553179038dbcdda91f417205fd43f58aa6bc10dd524a7c6835c951ac1f4e2b8e0639f3daad2de648d49876e787f6f911ce2130ee822d
-  data.tar.gz: 48ea64a75160012db6e407df73067252dc570a370c5b7968fb061f2621f468efde0973b26ad484caed947859e6f37122d7c5f3316d0f220b62a120c8b8fd81ef
+  metadata.gz: 27f4f025e16759d0403e121164843047a582057e94874be251d167ad585401dc6125eb88960573bb25b1e9c2e0f8c012ef79548f1c963e2d29910fb1a4b7843d
+  data.tar.gz: d78db1e5fb6f70df4cdfef60f5339477c64a4a50f568f89dd6d10b32ee187ac7307543347b952caeeb30983c8fdc92a207ef25823e4b53fcab15436400adf3ed

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [0.8.2] - 2026-04-16
+
+### Added
+- README documentation and spec coverage for `Client#head` — request signature, empty-body response contract, and full middleware/retry/pool/interceptor pipeline behavior
+
+## [0.8.1] - 2026-04-07
+
+### Added
+- `ConfigurationError` raised at initialization for invalid `timeout`, `open_timeout`, `read_timeout`, `write_timeout`, `retries`, `retry_delay`, `retry_backoff`, or `retry_on_status` values — fail fast instead of producing confusing runtime errors
+
 ## [0.8.0] - 2026-04-05
 
 ### Added

data/README.md

@@ -396,6 +396,21 @@ client.get("/users")
 # Prints: GET https://api.example.com/users -> 200 (0.234s)
 ```
 
+### HEAD requests
+
+Issue a HEAD request to retrieve response headers without downloading the body. The call mirrors `#get` — same options, same middleware/retry/pool pipeline — but the returned `Response#body` is always the empty string:
+
+```ruby
+response = client.head("/resource", headers: { "If-None-Match" => "abc123" })
+
+response.status              # => 200
+response.body                # => ""
+response.headers["etag"]     # => "W/\"abc123\""
+response.headers["content-length"]  # => "1024"
+```
+
+HEAD requests honor `params`, `headers`, `timeout`, `expect`, and `request_id` just like GET.
+
 ### All HTTP methods
 
 ```ruby
@@ -489,6 +504,7 @@ client.head("/resource")
 | Class | Description |
 |-------|-------------|
 | `Error` | Base error class (inherits `StandardError`) |
+| `ConfigurationError` | Invalid client option (negative timeout, bad retry config, etc.) |
 | `TimeoutError` | Connection or read timeout |
 | `NetworkError` | Connection refused, reset, unreachable |
 | `HttpError` | Response status mismatch (has `.response` accessor) |

data/lib/philiprehberger/http_client/client.rb

@@ -32,8 +32,10 @@ module Philiprehberger
         @base_url = base_url.chomp('/')
         @default_headers = headers
         @timeout = timeout
+        validate_timeout!(:timeout, timeout)
         assign_timeout_opts(opts)
         assign_retry_opts(opts)
+        validate_config!
         assign_cookie_opts(opts)
         assign_proxy_opts(opts)
         assign_redirect_opts(opts)
@@ -229,6 +231,31 @@ module Philiprehberger
         @open_timeout = opts[:open_timeout]
         @read_timeout = opts[:read_timeout]
         @write_timeout = opts[:write_timeout]
+        validate_timeout!(:open_timeout, @open_timeout)
+        validate_timeout!(:read_timeout, @read_timeout)
+        validate_timeout!(:write_timeout, @write_timeout)
+      end
+
+      def validate_timeout!(name, value)
+        return if value.nil?
+        raise ConfigurationError, "#{name} must be Numeric, got #{value.class}" unless value.is_a?(Numeric)
+        raise ConfigurationError, "#{name} must be non-negative, got #{value}" if value.negative?
+      end
+
+      def validate_config!
+        unless @retries.is_a?(Integer) && !@retries.negative?
+          raise ConfigurationError, "retries must be a non-negative Integer, got #{@retries.inspect}"
+        end
+        unless @retry_delay.is_a?(Numeric) && !@retry_delay.negative?
+          raise ConfigurationError, "retry_delay must be a non-negative Numeric, got #{@retry_delay.inspect}"
+        end
+        unless %i[fixed exponential].include?(@retry_backoff)
+          raise ConfigurationError, "retry_backoff must be :fixed or :exponential, got #{@retry_backoff.inspect}"
+        end
+        return if @retry_on_status.nil?
+        return if @retry_on_status.respond_to?(:include?)
+
+        raise ConfigurationError, 'retry_on_status must be an Array of status codes'
       end
 
       def assign_retry_opts(opts)

data/lib/philiprehberger/http_client/errors.rb

@@ -5,6 +5,9 @@ module Philiprehberger
     # Base error class for all HTTP client errors.
     class Error < StandardError; end
 
+    # Raised when client configuration is invalid (e.g. negative timeout).
+    class ConfigurationError < Error; end
+
     # Raised when a connection or read timeout occurs.
     class TimeoutError < Error; end
 

data/lib/philiprehberger/http_client/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module HttpClient
-    VERSION = '0.8.0'
+    VERSION = '0.8.2'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-http_client
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.8.2
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-06 00:00:00.000000000 Z
+date: 2026-04-16 00:00:00.000000000 Z
 dependencies: []
 description: A zero-dependency HTTP client built on Ruby's net/http with automatic
   retries, request/response interceptors, and a clean API for JSON services.