http-negotiate 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5eba28c71dd714d3254c4f9d0922b9c337ac5ec1ef91c353abd276aea7ec58ad
-  data.tar.gz: 714671385c02e7977da9adbef08e8cab7cf7665fd146e64613ba18814fbc2922
+  metadata.gz: 6c40df3f0c699e99b0f45c3af71e19e5461878bddecf1a8a28a4125965cc05c9
+  data.tar.gz: 58dfdd11e0a9b119f5e84bdb24e8d2d28145e91d7a8fa3d5d3067572d1c2980e
 SHA512:
-  metadata.gz: '085588d4db497e88d80de41198fff309d3ff0babe419803e5b915b150a5717a24b849cca6219593da6e122490b18676c199f793d626ec860d3bafb49011db278'
-  data.tar.gz: fc87172adb4cd18ae9ede3e373655cef0c67d20d2f37989d8fb6e5f464f602ed0f333a5a8e63db0b1c1e5ca70da66d13efd98715cd643dc08944b70a96fb53e9
+  metadata.gz: 0610a598b694dfa3a147257e160dfbfafcde951715ff7329f489b22e097490e2999f84a8401ef6019183f30fbbdbe01c31c4daf7dd9abcab34402add0a1f96bc
+  data.tar.gz: b3a19ba49afe90cd32aba42046ec57af147bb1a12f7087102fed03e5520c30cc33fecc41785a226cf7a5680298adcb59ea2b14a9bcd6950db3b2148109a070be

data/.yardopts

@@ -0,0 +1,5 @@
+--markup=markdown
+--no-private
+- README.md
+- LICENSE
+- CHANGELOG.md

data/http-negotiate.gemspec

@@ -31,5 +31,5 @@ Gem::Specification.new do |spec|
   # dev/test dependencies
   spec.add_development_dependency 'bundler', '~> 2.2'
   spec.add_development_dependency 'rake',    '~> 13.0'
-  spec.add_development_dependency 'rspec',   '~> 3.10'
+  spec.add_development_dependency 'rspec',   '~> 3.12'
 end

data/lib/http/negotiate/version.rb

@@ -1,5 +1,5 @@
 module HTTP
   module Negotiate
-    VERSION = '0.1.3'
+    VERSION = '0.2.0'
   end
 end

data/lib/http/negotiate.rb

@@ -13,32 +13,31 @@ module HTTP::Negotiate
 
   public
 
-  # The variant mapping takes the following form:
-  # { variant => [weight, type, encoding, charset, language, size] }
-  #
-  # (Alternatively this array can be a hash with the same keys as symbols.)
-  #
-  # * the variant can be anything, including the actual variant
-  # * the weight is a number between 0 and 1 denoting the initial
-  #   preference for the variant
-  # * type, encoding, charset, language are all strings containing
-  #   their respective standardized tokens (note "encoding" is like
-  #   `gzip`, not like `utf-8`: that's "charset")
-  # * size is the number of bytes, an integer
+  # Return a parsed representation of the relevant header
+  # set. Translates `Accept-*` (`HTTP_ACCEPT_*`) into lower-case
+  # symbols, so `Accept-Language` or `HTTP_ACCEPT_LANGUAGE` becomes
+  # `:language`. Same for `:charset`, and `:encoding`, etc., save for
+  # plain `Accept` which is translated to `:type`. The parameter
+  # `:add_langs` will supplement `Accept-Language` assertions of
+  # specific languages with their more generic counterparts, if not
+  # already present in the header, with a slightly lower quality
+  # score, e.g. `en-us` adds `en;q=0.999`, `zh-cn;q=0.8` adds
+  # `zh;q=0.799`.
   #
-  # Returns either the winning variant or all variants if requested,
-  # sorted by the algorithm, or nil or the empty array if none are
-  # selected.
+  # @param request [Hash, Rack::Request, #env] Anything roughly a hash
+  #  of headers
+  # @param add_langs [false, true] whether to supplement language tags
   #
-  # @param request [Hash,Rack::Request,#env] Anything roughly a hash of headers
-  # @param variants [Hash] the variants, described above
-  # @param add_langs [false, true] whether to supplant language tags
-  # @param all [false, true] whether to return a sorted list or not
-  # @param cmp [Proc] a secondary comparison of variants as a tiebreaker
+  # @return [Hash] the parsed `Accept*` headers
   #
-  def negotiate request, variants, add_langs: false, all: false, cmp: nil
+  def parse_headers request, add_langs: false
     # pull accept headers
     request = request.env if request.respond_to? :env
+
+    # no-op if this is already parsed
+    return request if request.is_a? Hash and
+      request.all? { |k, v| k.is_a? Symbol and v.is_a? Hash }
+
     # this will ensure that the keys will match irrespective of
     # whether it's passed in as actual http headers or a cgi-like env
     request = request.transform_keys do |k|
@@ -67,7 +66,7 @@ module HTTP::Negotiate
           params = params.map do |p|
             k, v = p.split(/=+/, 2)
             k = k.downcase.to_sym
-            v = v.to_f if v and k == :q 
+            v = v.to_f if v and k == :q
             [k, v]
           end.to_h
           if params[:q]
@@ -100,6 +99,35 @@ module HTTP::Negotiate
       end
     end
 
+    accept
+  end
+
+  # The variant mapping takes the following form:
+  # { variant => [weight, type, encoding, charset, language, size] }
+  #
+  # (Alternatively this array can be a hash with the same keys as symbols.)
+  #
+  # * the variant can be anything, including the actual variant
+  # * the weight is a number between 0 and 1 denoting the initial
+  #   preference for the variant
+  # * type, encoding, charset, language are all strings containing
+  #   their respective standardized tokens (note "encoding" is like
+  #   `gzip`, not like `utf-8`: that's "charset")
+  # * size is the number of bytes, an integer
+  #
+  # Returns either the winning variant or all variants if requested,
+  # sorted by the algorithm, or nil or the empty array if none are
+  # selected.
+  #
+  # @param request [Hash,Rack::Request,#env] Anything roughly a hash of headers
+  # @param variants [Hash] the variants, described above
+  # @param add_langs [false, true] whether to supplement language tags
+  # @param all [false, true] whether to return a sorted list or not
+  # @param cmp [Proc] a secondary comparison of variants as a tiebreaker
+  #
+  def negotiate request, variants, add_langs: false, all: false, cmp: nil
+    accept = parse_headers request, add_langs: add_langs
+
     # convert variants to array
     variants = variants.transform_values do |v|
       v.is_a?(Hash) ? v.values_at(*KEYS) : v
@@ -155,7 +183,7 @@ module HTTP::Negotiate
             test = i > 0 ? lang.slice(0, i).join(?-) : ?*
             if accept[:language][test]
               al = accept[:language][test][:q]
-              # *;q=0 will override 
+              # *;q=0 will override
               if al == 0 and test != ?*
                 ql = 0
                 break

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: http-negotiate
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Dorian Taylor
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-11-09 00:00:00.000000000 Z
+date: 2023-08-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: '3.12'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.10'
+        version: '3.12'
 description:
 email:
 - code@doriantaylor.com
@@ -62,6 +62,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - ".travis.yml"
+- ".yardopts"
 - Gemfile
 - LICENSE
 - README.md
@@ -93,7 +94,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.3.15
 signing_key:
 specification_version: 4
 summary: An implementation of Gisle Aas's HTTP::Negotiate