# frozen_string_literal: true module Sprockets # Internal: HTTP URI utilities. Many adapted from Rack::Utils. Mixed into # Environment. module HTTPUtils extend self # Public: Test mime type against mime range. # # match_mime_type?('text/html', 'text/*') => true # match_mime_type?('text/plain', '*') => true # match_mime_type?('text/html', 'application/json') => false # # Returns true if the given value is a mime match for the given mime match # specification, false otherwise. def match_mime_type?(value, matcher) v1, v2 = value.split('/'.freeze, 2) m1, m2 = matcher.split('/'.freeze, 2) (m1 == '*'.freeze || v1 == m1) && (m2.nil? || m2 == '*'.freeze || m2 == v2) end # Public: Return values from Hash where the key matches the mime type. # # hash - Hash of String matcher keys to Object values # mime_type - String mime type # # Returns Array of Object values. def match_mime_type_keys(hash, mime_type) type, subtype = mime_type.split('/', 2) [ hash["*"], hash["*/*"], hash["#{type}/*"], hash["#{type}/#{subtype}"] ].compact end # Internal: Parse Accept header quality values. # # values - String e.g. "application/javascript" # # Adapted from Rack::Utils#q_values. Quality values are # described in http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html # # parse_q_values("application/javascript") # # => [["application/javascript", 1.0]] # # parse_q_values("*/*") # # => [["*/*", 1.0]] # # parse_q_values("text/plain; q=0.5, image/*") # # => [["text/plain", 0.5], ["image/*", 1.0]] # # parse_q_values("application/javascript, text/css") # # => [["application/javascript", 1.0], ["text/css", 1.0]] # # Returns an Array of [String, Float]. def parse_q_values(values) values.to_s.split(/\s*,\s*/).map do |part| value, parameters = part.split(/\s*;\s*/, 2) quality = 1.0 if md = /\Aq=([\d.]+)/.match(parameters) quality = md[1].to_f end [value, quality] end end # Internal: Find all qvalue matches from an Array of available options. # # Adapted from Rack::Utils#q_values. # # Returns Array of matched Strings from available Array or []. def find_q_matches(q_values, available, &matcher) matcher ||= lambda { |a, b| a == b } matches = [] case q_values when Array when String q_values = parse_q_values(q_values) when NilClass q_values = [] else raise TypeError, "unknown q_values type: #{q_values.class}" end i = 0 q_values.each do |accepted, quality| if match = available.find { |option| matcher.call(option, accepted) } i += 1 matches << [-quality, i, match] end end matches.sort! matches.map! { |_, _, match| match } matches end # Internal: Find the best qvalue match from an Array of available options. # # Adapted from Rack::Utils#q_values. # # Returns the matched String from available Array or nil. def find_best_q_match(q_values, available, &matcher) find_q_matches(q_values, available, &matcher).first end # Internal: Find the all qvalue match from an Array of available mime type # options. # # Adapted from Rack::Utils#q_values. # # Returns Array of matched mime type Strings from available Array or []. def find_mime_type_matches(q_value_header, available) find_q_matches(q_value_header, available) do |a, b| match_mime_type?(a, b) end end # Internal: Find the best qvalue match from an Array of available mime type # options. # # Adapted from Rack::Utils#q_values. # # Returns the matched mime type String from available Array or nil. def find_best_mime_type_match(q_value_header, available) find_best_q_match(q_value_header, available) do |a, b| match_mime_type?(a, b) end end end end