philiprehberger-http_client 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 211aea712ab77e8a14f5a565d0a235113b1b5a5630e38e13ddcfb2f92c61b141
-  data.tar.gz: d9a7e6996c9ca7cc6ba296c837db466cdc692abb489bb179c24aea3e888e274b
+  metadata.gz: a22fdf41ff535b768c6ac9783ad358b8367cf7aa9f666368cd098c30ef36231c
+  data.tar.gz: 62bb80048febfa5be44bfef001cd082bf447866a2a4d5afe76717e2e829e9423
 SHA512:
-  metadata.gz: 9cf88a13252d7b73c94b747a0ce54cc5027dbdb28aceaefeca3cf5c4d5c2818b09d8b7b9c92e7cbda000a8343fda30aff88f9110a0d96eccb0b9cada3e84d67e
-  data.tar.gz: 716b066adc90993966528dc3100dcb1b6d4e9130926673ee1279d2931e2f0089a2f0999e22fcfade122e9afd1a641e2e7a6c566594845efd8864ac9b0683bfdf
+  metadata.gz: 75d9a2a474f77b8358ea76fb131acdcb2f11c9fdc31b46d4dc65ec6364139de9e6fd66b085f65b294afde442b0e9b12a73c1775cbc5c7ad2f3275544bb5d58ae
+  data.tar.gz: f728d0e5d12a7642e098c75fca3af7ef75aff526329982678e224c4917cd921164170319db294ad33ba1ca3bd923f39b442082bbb17f8a1fd8140873125325ce

data/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.13.0] - 2026-10-30
+
+### Added
+- `Response#raise_for_status!` — returns `self` on 2xx/3xx responses and raises `HttpError` (with `.response`) on 4xx/5xx, enabling chained calls like `client.get(path).raise_for_status!.json`
+- `Response#content_type` — media type from the `Content-Type` header without parameters (e.g. `"application/json"`), `nil` if absent
+- `Response#content_length` — `Content-Length` header as an Integer, `nil` if absent or invalid
+
+### Changed
+- Aligned `.gitignore` with the standard gem template
+- Aligned CI workflow with the standard template (`ruby` matrix key, glob gemspec in build/push)
+
 ## [0.12.0] - 2026-07-15
 
 ### Added
@@ -211,7 +222,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 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.12.0...HEAD
+[Unreleased]: https://github.com/philiprehberger/rb-http-client/compare/v0.13.0...HEAD
+[0.13.0]: https://github.com/philiprehberger/rb-http-client/compare/v0.12.0...v0.13.0
 [0.12.0]: https://github.com/philiprehberger/rb-http-client/compare/v0.11.1...v0.12.0
 [0.11.1]: https://github.com/philiprehberger/rb-http-client/compare/v0.11.0...v0.11.1
 [0.11.0]: https://github.com/philiprehberger/rb-http-client/compare/v0.10.0...v0.11.0

data/README.md

@@ -467,6 +467,25 @@ response.header("etag")           # works for any casing
 response.header("X-Missing")      # => nil
 ```
 
+### Content metadata and status checks
+
+`Response#content_type` returns the media type without parameters, `Response#content_length` parses the `Content-Length` header, and `Response#raise_for_status!` raises `HttpError` on 4xx/5xx while returning the response otherwise:
+
+```ruby
+response = client.get("/report")
+
+response.content_type    # => "application/json" (from "application/json; charset=utf-8")
+response.content_length  # => 2048, or nil if the header is absent
+
+data = client.get("/users").raise_for_status!.json
+
+begin
+  client.get("/missing").raise_for_status!
+rescue Philiprehberger::HttpClient::HttpError => e
+  e.response.status  # => 404
+end
+```
+
 ## API
 
 ### `Philiprehberger::HttpClient.new(**options)`
@@ -545,6 +564,9 @@ response.header("X-Missing")      # => nil
 | `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 |
+| `content_type` | String | Media type without parameters (e.g. `"application/json"`), `nil` if absent |
+| `content_length` | Integer | `Content-Length` header as an Integer, `nil` if absent or invalid |
+| `raise_for_status!` | Response | Returns `self` on 1xx-3xx, raises `HttpError` (with `.response`) on 4xx/5xx |
 | `streaming?` | Boolean | `true` if response was streamed |
 | `metrics` | Metrics | Request timing breakdown (total_time, first_byte_time, etc.) |
 | `redirects` | Array | Redirect chain URLs (empty if no redirects) |

data/lib/philiprehberger/http_client/response.rb

@@ -83,6 +83,45 @@ module Philiprehberger
         primary == 'application/json' || primary.end_with?('+json')
       end
 
+      # Returns the media type from the `Content-Type` header without any
+      # parameters (e.g. `"application/json"` for
+      # `"application/json; charset=utf-8"`). The value is downcased.
+      #
+      # @return [String, nil] the media type, or `nil` if the header is absent or blank
+      def content_type
+        value = header('content-type')
+        return nil if value.nil?
+
+        media_type = value.to_s.split(';').first.to_s.strip.downcase
+        media_type.empty? ? nil : media_type
+      end
+
+      # Returns the `Content-Length` header as an Integer.
+      #
+      # @return [Integer, nil] the declared body length, or `nil` if the header
+      #   is absent or not a valid non-negative integer
+      def content_length
+        value = header('content-length')
+        return nil if value.nil?
+
+        length = Integer(value.to_s.strip, 10, exception: false)
+        length&.negative? ? nil : length
+      end
+
+      # Raises {HttpError} if the response has a 4xx or 5xx status code.
+      # Returns `self` otherwise so the call can be chained.
+      #
+      # @example
+      #   data = client.get('/users').raise_for_status!.json
+      #
+      # @return [self]
+      # @raise [HttpError] if the status code is 400 or greater
+      def raise_for_status!
+        raise HttpError, self if status >= 400
+
+        self
+      end
+
       # Returns request timing metrics (nil if not available).
       #
       # @return [Metrics, nil]

data/lib/philiprehberger/http_client/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module HttpClient
-    VERSION = '0.12.0'
+    VERSION = '0.13.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-http_client
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-16 00:00:00.000000000 Z
+date: 2026-10-30 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.