philiprehberger-header_kit 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b397e499d587d20070ad785372aa81dc6574f583de2663cb105598ba229f3b52
-  data.tar.gz: cf8de787ddaa0f5cf2c95efa89f17e8db64d0368262bdd691b29c029fc0587fe
+  metadata.gz: 7515c78405c89a2690d8a4fc48b802bdf9c5b79dd9deae14fe07de8a8673d2df
+  data.tar.gz: ca05991394f985b4b5b0148a6db2c826bc9101eb04787b6f6adf9c4d2839ab1b
 SHA512:
-  metadata.gz: 600588c8096d75b8b8559a2aa0d9477025a7e02706e3906f7c57297999f303083078f8dd7dfe75c70a56a2ddb6e424d88c69e94b11cfee8a9038eb1c1e7bc275
-  data.tar.gz: 9984feba85757ee07365321359798fe91a87c0f44902c65c81f52bb1885683c0971ea78590eee5db427e952afe72bbc1dceee4eba39478ca90e24e04622bcb97
+  metadata.gz: 02ce3113575c5c98db4e4b010138861a983488db0e888b09644dfe6162b48af2864190b815f82d33d1e0b6cbf5855eed176b1ec6bd30fdd73966f7be59b538b1
+  data.tar.gz: 387dd665c493e2d308e3cb76581733691d231d2160e3c6ad6cee724a818470f3fb31e089dd607206680738508b204f5630c0c48fae4f1c05ed89ed97c2bd4057

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-04
+
+### Added
+
+- `parse_retry_after` for parsing Retry-After headers (numeric seconds or HTTP date)
+
 ## [0.3.1] - 2026-03-31
 
 ### Changed

data/README.md

@@ -181,6 +181,16 @@ Philiprehberger::HeaderKit.parse_via('1.1 vegur, 1.0 fred')
 # => [{protocol: "1.1", host: "vegur"}, {protocol: "1.0", host: "fred"}]
 ```
 
+### Parse Retry-After
+
+```ruby
+Philiprehberger::HeaderKit.parse_retry_after("120")
+# => {seconds: 120}
+
+Philiprehberger::HeaderKit.parse_retry_after("Fri, 04 Apr 2026 12:00:00 GMT")
+# => {date: 2026-04-04 12:00:00 UTC}
+```
+
 ## API
 
 | Method | Description |
@@ -204,6 +214,7 @@ Philiprehberger::HeaderKit.parse_via('1.1 vegur, 1.0 fred')
 | `HeaderKit.security_headers(**options)` | Generate recommended security headers |
 | `HeaderKit.parse_forwarded(header)` | Parse RFC 7239 Forwarded header |
 | `HeaderKit.parse_via(header)` | Parse Via header into structured entries |
+| `HeaderKit.parse_retry_after(header)` | Parse Retry-After header (seconds or HTTP date) |
 
 ## Development
 

data/lib/philiprehberger/header_kit/retry_after.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'time'
+
+module Philiprehberger
+  module HeaderKit
+    module RetryAfter
+      module_function
+
+      def parse(header)
+        return nil if header.nil? || header.empty?
+
+        if header.match?(/\A\d+\z/)
+          { seconds: header.to_i }
+        else
+          { date: Time.httpdate(header) }
+        end
+      end
+    end
+  end
+end

data/lib/philiprehberger/header_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module HeaderKit
-    VERSION = '0.3.1'
+    VERSION = '0.4.0'
   end
 end

data/lib/philiprehberger/header_kit.rb

@@ -14,6 +14,7 @@ require_relative 'header_kit/negotiation'
 require_relative 'header_kit/cors'
 require_relative 'header_kit/security'
 require_relative 'header_kit/forwarded'
+require_relative 'header_kit/retry_after'
 
 module Philiprehberger
   module HeaderKit
@@ -174,5 +175,16 @@ module Philiprehberger
     def self.parse_via(header)
       Forwarded.parse_via(header)
     end
+
+    # Parse a Retry-After header.
+    #
+    # Returns a hash with :seconds (Integer) for numeric values,
+    # or :date (Time) for HTTP date values. Returns nil for nil/empty input.
+    #
+    # @param header [String] the Retry-After header value
+    # @return [Hash, nil] hash with :seconds or :date key, or nil
+    def self.parse_retry_after(header)
+      RetryAfter.parse(header)
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-header_kit
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-05 00:00:00.000000000 Z
 dependencies: []
 description: Parse and build Accept, Accept-Language, Accept-Encoding, Authorization,
   Cache-Control, Content-Type, Cookie, Link, CORS, Forwarded, and Via HTTP headers.
@@ -35,6 +35,7 @@ files:
 - lib/philiprehberger/header_kit/forwarded.rb
 - lib/philiprehberger/header_kit/link.rb
 - lib/philiprehberger/header_kit/negotiation.rb
+- lib/philiprehberger/header_kit/retry_after.rb
 - lib/philiprehberger/header_kit/security.rb
 - lib/philiprehberger/header_kit/version.rb
 homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-header_kit