philiprehberger-http_client 0.9.1 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87104396621af222e4e5c94c6f7bdaedbfd6ff95ad89d9e147e7980ab33d868f
-  data.tar.gz: 9b814c9ded6a9792d4dd782343e9b622790dc0d6cd86c6979b7e54c300031e02
+  metadata.gz: 0e7ebec429195d4e674adf7836c916e2e9fa40938c1fe79209d8c10ad4c0df5d
+  data.tar.gz: 94fd543943abe6573cb5ce9bdc686bc5c7aa79858b312aab251a4851c4f9718f
 SHA512:
-  metadata.gz: 1e8c83eff3473cd63ea842deb56a7660aeb3fcf3139ba4ae22da7f279f45d8e9686a1e4091dea1e583314c1c682d32f4dab9fb0082521841fbd9cb8825a545e3
-  data.tar.gz: 58b943703382d92960828bf002b7e00e48e45ffcc1a27b8dfaae4ece0d8b047181f440272fffac0bb87bbb10dfc1c02d2c07e732d291faadec83b0b200239a31
+  metadata.gz: ba7e2ba9e18a068391353b8164393deb5205faa86367fffb1101b782ca08e72d1db2c8eecf8343621062b61629268c09254c9a597d333da59657979903090882
+  data.tar.gz: 2ab2ebe6ab143e5417e7939905c9b971bce1237cf434f0d4a360f912ab02d37468affa783368297ed11e1de44689847239a55f9fbd7e51864c9ba7ec6be595fa

data/CHANGELOG.md

@@ -3,10 +3,27 @@
 All notable changes to this gem will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.11.0] - 2026-05-13
+
+### Added
+- `Response#header(name)` — case-insensitive header value accessor. Returns `nil` when the header is absent.
+
+### Changed
+- `Response#json?` now delegates to `Response#header` for Content-Type lookup.
+
+## [0.10.0] - 2026-05-07
+
+### Added
+- `Response#client_error?` — returns true for 4xx status codes.
+- `Response#server_error?` — returns true for 5xx status codes.
+
+### Changed
+- CHANGELOG header wording aligned with the standard template ("this project adheres" instead of "this gem adheres").
+
 ## [0.9.1] - 2026-04-23
 
 ### Changed
@@ -177,7 +194,9 @@ and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 - Response wrapper with `ok?` and `json` convenience methods
 - Zero dependencies — built on Ruby stdlib `net/http`
 
-[Unreleased]: https://github.com/philiprehberger/rb-http-client/compare/v0.9.1...HEAD
+[Unreleased]: https://github.com/philiprehberger/rb-http-client/compare/v0.11.0...HEAD
+[0.11.0]: https://github.com/philiprehberger/rb-http-client/compare/v0.10.0...v0.11.0
+[0.10.0]: https://github.com/philiprehberger/rb-http-client/compare/v0.9.1...v0.10.0
 [0.9.1]: https://github.com/philiprehberger/rb-http-client/compare/v0.9.0...v0.9.1
 [0.9.0]: https://github.com/philiprehberger/rb-http-client/compare/v0.8.2...v0.9.0
 [0.8.2]: https://github.com/philiprehberger/rb-http-client/compare/v0.8.1...v0.8.2

data/README.md

@@ -38,9 +38,11 @@ require "philiprehberger/http_client"
 client = Philiprehberger::HttpClient.new(base_url: "https://api.example.com")
 
 response = client.get("/users", params: { page: 1 })
-puts response.status  # => 200
-puts response.ok?     # => true
-puts response.json    # => [{"id" => 1, "name" => "Alice"}, ...]
+puts response.status         # => 200
+puts response.ok?            # => true
+puts response.client_error?  # => false (true for 4xx)
+puts response.server_error?  # => false (true for 5xx)
+puts response.json           # => [{"id" => 1, "name" => "Alice"}, ...]
 ```
 
 ### POST with JSON body
@@ -422,6 +424,18 @@ client.delete("/resource/1")
 client.head("/resource")
 ```
 
+### Case-insensitive header lookup
+
+`Response#header` returns the value for a header regardless of capitalization, returning `nil` when it is missing:
+
+```ruby
+response = client.head("/resource")
+
+response.header("Content-Type")  # => "application/json"
+response.header("etag")           # works for any casing
+response.header("X-Missing")      # => nil
+```
+
 ## API
 
 ### `Philiprehberger::HttpClient.new(**options)`
@@ -491,7 +505,10 @@ client.head("/resource")
 | `status`  | Integer | HTTP status code                |
 | `body`    | String  | Raw response body (`nil` if streamed) |
 | `headers` | Hash    | Response headers                |
+| `header(name)` | String | Header value for `name` (case-insensitive), `nil` if absent |
 | `ok?`     | Boolean | `true` if status is 200-299     |
+| `client_error?` | Boolean | Returns true for 4xx status codes |
+| `server_error?` | Boolean | Returns true for 5xx status codes |
 | `json`    | Hash    | Parsed JSON body                |
 | `json?`   | Boolean | `true` if `Content-Type` is `application/json` or `+json` suffix |
 | `streaming?` | Boolean | `true` if response was streamed |

data/lib/philiprehberger/http_client/response.rb

@@ -29,6 +29,20 @@ module Philiprehberger
         status >= 200 && status < 300
       end
 
+      # Returns true if the status code is in the 4xx range.
+      #
+      # @return [Boolean]
+      def client_error?
+        status >= 400 && status < 500
+      end
+
+      # Returns true if the status code is in the 5xx range.
+      #
+      # @return [Boolean]
+      def server_error?
+        status >= 500 && status < 600
+      end
+
       # Returns true if the response was streamed.
       #
       # @return [Boolean]
@@ -44,6 +58,17 @@ module Philiprehberger
         @json ||= JSON.parse(body)
       end
 
+      # Returns the header value for `name`, matching case-insensitively.
+      # Returns `nil` when the header is not present.
+      #
+      # @param name [String, Symbol] header name (case-insensitive)
+      # @return [String, nil]
+      def header(name)
+        key = name.to_s.downcase
+        headers.each { |k, v| return v if k.to_s.downcase == key }
+        nil
+      end
+
       # Returns true if the `Content-Type` response header advertises JSON.
       # Matches `application/json`, `application/problem+json`, and any
       # other `+json` structured-syntax suffix defined by RFC 6838.
@@ -51,11 +76,11 @@ module Philiprehberger
       #
       # @return [Boolean]
       def json?
-        header = headers.find { |k, _| k.to_s.downcase == 'content-type' }
-        return false unless header
+        value = header('content-type')
+        return false unless value
 
-        value = header[1].to_s.downcase.split(';').first.to_s.strip
-        value == 'application/json' || value.end_with?('+json')
+        primary = value.to_s.downcase.split(';').first.to_s.strip
+        primary == 'application/json' || primary.end_with?('+json')
       end
 
       # Returns request timing metrics (nil if not available).

data/lib/philiprehberger/http_client/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module HttpClient
-    VERSION = '0.9.1'
+    VERSION = '0.11.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-http_client
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.11.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-23 00:00:00.000000000 Z
+date: 2026-05-14 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.