Module: HTTP::Accept::Charsets

Defined in:
lib/http/accept/charsets.rb

Defined Under Namespace

Classes: Charset

Constant Summary collapse

QVALUE =

tools.ietf.org/html/rfc7231#section-5.3.1

/0(\.[0-9]{0,3})?|1(\.[0]{0,3})?/
CHARSETS =

tools.ietf.org/html/rfc7231#section-5.3.3

/(?<charset>#{TOKEN})(;q=(?<q>#{QVALUE}))?/
HTTP_ACCEPT_CHARSET = 
'HTTP_ACCEPT_CHARSET'.freeze
WILDCARD_CHARSET = 
Charset.new('*', nil).freeze

Class Method Summary collapse

Class Method Details

.browser_preferred_charsets(env) ⇒ Object

Parse the list of browser preferred charsets and return ordered by priority.



67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
 
# File 'lib/http/accept/charsets.rb', line 67

def self.browser_preferred_charsets(env)
  if accept_charsets = env[HTTP_ACCEPT_CHARSET]
    accept_charsets.strip!
    
    if accept_charsets.empty?
      # https://tools.ietf.org/html/rfc7231#section-5.3.3 :
      #
      #    Accept-Charset = 1#( ( charset / "*" ) [ weight ] )
      #
      # Because of the `1#` rule, an empty header value is not considered valid.
      raise ParseError.new('Could not parse entire string!')
    else
      return HTTP::Accept::Charsets.parse(accept_charsets)
    end
  end
  
  # "A request without any Accept-Charset header field implies that the
  #  user agent will accept any charset in response."
  return [WILDCARD_CHARSET]
end

.parse(text) ⇒ Object 



55
56
57
58
59
60
61
 
# File 'lib/http/accept/charsets.rb', line 55

def self.parse(text)
  scanner = StringScanner.new(text)
  
  charsets = Charset.parse(scanner)
  
  return Sort.by_quality_factor(charsets)
end