philiprehberger-header_kit 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d06951b5686f64b328c573fc16904e84eddfc61424ab8491fc2da817c7241fca
-  data.tar.gz: 9bdc24a4fc3dabc8d34ccdc105564e5669e9024ada60869c09317fdc11f1c1d6
+  metadata.gz: 255a0f1f4321e63ae82d6acaf028cddb9a041d4f1594b16dcbb8f2a51f54a286
+  data.tar.gz: 1a0ea312d1937e9e17c7cabe31f7822345d0de02f4627d09c597c5a71a5b7715
 SHA512:
-  metadata.gz: 82e06b0e3e146393f17782091fd76c5813be7c46df09c6366d9e892d40a4d05e652655b0017c2cd8242a8812961b428f853cb771e74721e08c46b778911dd124
-  data.tar.gz: f9970a177aa61fa120ea97eceeeda50f19d9517c143b2d91c4bce924a26466c13de2ca88f2a5e00375cadebae0cf2f804436ace824ac0fa3a53d00dbf8f4efec
+  metadata.gz: ee48374d55f01e11ae5b499c31556037801082a6631ed60306d544109897715bf5510eff7403675e2e94795257903efe289469bd790181cc2c32fef70e65a975
+  data.tar.gz: 40cf00b3c4d3d9f88d50ab21f08fc2dfb2d75b9ee13e879f985d59b28a14e81c600376d13d8f13f9bafb4edd3ff9350d6c4f6d5766abf20e9dd94bd2fd9e706c

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-04-23
+
+### Added
+- `HeaderKit.build_accept_encoding(encodings)` for constructing Accept-Encoding headers from an array of `{encoding:, quality:}` hashes, mirroring the existing `build_accept` builder
+
 ## [0.5.0] - 2026-04-17
 
 ### Added

data/README.md

@@ -66,6 +66,17 @@ Philiprehberger::HeaderKit.parse_accept_encoding("gzip, deflate;q=0.5, br;q=0.8"
 # => [{encoding: "gzip", quality: 1.0}, {encoding: "br", quality: 0.8}, {encoding: "deflate", quality: 0.5}]
 ```
 
+### Build Accept-Encoding
+
+```ruby
+Philiprehberger::HeaderKit.build_accept_encoding([
+  {encoding: "gzip"},
+  {encoding: "br", quality: 0.9},
+  {encoding: "deflate", quality: 0.5}
+])
+# => "gzip, br;q=0.9, deflate;q=0.5"
+```
+
 ### Parse Authorization
 
 ```ruby
@@ -216,6 +227,7 @@ Philiprehberger::HeaderKit.parse_retry_after("Fri, 04 Apr 2026 12:00:00 GMT")
 | `HeaderKit.parse_accept_language(header)` | Parse Accept-Language into sorted entries |
 | `HeaderKit.negotiate_language(header, available)` | Language negotiation, returns best match or nil |
 | `HeaderKit.parse_accept_encoding(header)` | Parse Accept-Encoding into sorted entries |
+| `HeaderKit.build_accept_encoding(encodings)` | Build Accept-Encoding header string from encoding array |
 | `HeaderKit.parse_authorization(header)` | Parse Authorization header (Bearer, Basic, Digest) |
 | `HeaderKit.parse_cache_control(header)` | Parse Cache-Control into directive hash |
 | `HeaderKit.build_cache_control(directives)` | Build Cache-Control string from hash |

data/lib/philiprehberger/header_kit/accept_encoding.rb

@@ -50,7 +50,37 @@ module Philiprehberger
         value.to_f.clamp(0.0, 1.0)
       end
 
-      private_class_method :parse_entry, :parse_quality
+      # Build an Accept-Encoding header string from an array of encoding hashes.
+      #
+      # @param encodings [Array<Hash>] each with :encoding and optional :quality
+      # @return [String] formatted Accept-Encoding header value
+      def self.build(encodings)
+        return '' if encodings.nil? || encodings.empty?
+
+        parts = encodings.map do |entry|
+          encoding = entry[:encoding]
+          quality = entry[:quality]
+
+          if quality && quality < 1.0
+            "#{encoding};q=#{format_quality(quality)}"
+          else
+            encoding
+          end
+        end
+
+        parts.join(', ')
+      end
+
+      # Format a quality value, removing trailing zeros.
+      #
+      # @param quality [Float] the quality value
+      # @return [String] formatted quality string
+      def self.format_quality(quality)
+        formatted = format('%.3f', quality)
+        formatted.sub(/0+\z/, '').sub(/\.\z/, '.0')
+      end
+
+      private_class_method :parse_entry, :parse_quality, :format_quality
     end
   end
 end

data/lib/philiprehberger/header_kit/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module HeaderKit
-    VERSION = '0.5.0'
+    VERSION = '0.6.0'
   end
 end

data/lib/philiprehberger/header_kit.rb

@@ -45,6 +45,14 @@ module Philiprehberger
       AcceptEncoding.parse(header)
     end
 
+    # Build an Accept-Encoding header string from an array of encoding hashes.
+    #
+    # @param encodings [Array<Hash>] each with :encoding and optional :quality
+    # @return [String] formatted Accept-Encoding header value
+    def self.build_accept_encoding(encodings)
+      AcceptEncoding.build(encodings)
+    end
+
     # Parse an Accept-Language header into structured entries sorted by quality.
     #
     # @param header [String] the Accept-Language header value

metadata

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