Class: Protocol::HTTP::Header::Accept

Inherits:
Split
  • Object
show all
Defined in:
lib/protocol/http/header/accept.rb

Overview

The ‘accept-content-type` header represents a list of content-types that the client can accept.

Defined Under Namespace

Classes: MediaRange

Constant Summary collapse

SEPARATOR =

Regular expression used to split values on commas, with optional surrounding whitespace, taking into account quoted strings.

/
	(?:            # Start non-capturing group
		"[^"\\]*"    # Match quoted strings (no escaping of quotes within)
		|            # OR
		[^,"]+       # Match non-quoted strings until a comma or quote
	)+
	(?=,|\z)       # Match until a comma or end of string
/x
ParseError = 
Class.new(Error)
MEDIA_RANGE = 
/\A(?<type>#{TOKEN})\/(?<subtype>#{TOKEN})(?<parameters>.*)\z/
PARAMETER = 
/\s*;\s*(?<key>#{TOKEN})=((?<value>#{TOKEN})|(?<quoted_value>#{QUOTED_STRING}))/

Constants inherited from Split

Split::COMMA

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Split

coerce, #initialize

Constructor Details

This class inherits a constructor from Protocol::HTTP::Header::Split

Class Method Details

.parse(value) ⇒ Object

Parses a raw header value.



75
76
77
 
# File 'lib/protocol/http/header/accept.rb', line 75

def self.parse(value)
	self.new(value.scan(SEPARATOR).map(&:strip))
end

.trailer? ⇒ Boolean

Whether this header is acceptable in HTTP trailers.

Returns:

  • (Boolean) 


97
98
99
 
# File 'lib/protocol/http/header/accept.rb', line 97

def self.trailer?
	false
end

Instance Method Details

#<<(value) ⇒ Object

Adds one or more comma-separated values to the header.

The input string is split into distinct entries and appended to the array.



84
85
86
 
# File 'lib/protocol/http/header/accept.rb', line 84

def << value
	self.concat(value.scan(SEPARATOR).map(&:strip))
end

#media_ranges ⇒ Object

Parse the ‘accept` header.



104
105
106
107
108
 
# File 'lib/protocol/http/header/accept.rb', line 104

def media_ranges
	self.map do |value|
		self.parse_media_range(value)
	end
end

#to_s ⇒ Object

Converts the parsed header value into a raw header value.



91
92
93
 
# File 'lib/protocol/http/header/accept.rb', line 91

def to_s
	join(",")
end