class HTTP::Headers
HTTP Headers container.
def ==(other)
-
(Boolean)
-
def ==(other) return false unless other.respond_to? :to_a @pile == other.to_a end
def [](name)
-
(Array
- if header has more than one value) -
(String)
- if header has exactly one value -
(nil)
- if header was not set
def [](name) values = get(name) case values.count when 0 then nil when 1 then values.first else values end end
def add(name, value)
-
(void)
-
Parameters:
-
value
(Array<#to_s>, #to_s
) -- header value(s) to be appended -
name
(#to_s
) -- header name
def add(name, value) name = normalize_header name.to_s Array(value).each { |v| @pile << [name, v.to_s] } end
def coerce(object)
-
(Headers)
-
Parameters:
-
object
(#to_hash, #to_h, #to_a
) --
Raises:
-
(Error)
- if object can't be coerced
def coerce(object) unless object.is_a? self object = case when object.respond_to?(:to_hash) then object.to_hash when object.respond_to?(:to_h) then object.to_h when object.respond_to?(:to_a) then object.to_a else raise Error, "Can't coerce #{object.inspect} to Headers" end end headers = new object.each { |k, v| headers.add k, v } headers end
def delete(name)
-
(void)
-
Parameters:
-
name
(#to_s
) -- header name
def delete(name) name = normalize_header name.to_s @pile.delete_if { |k, _| k == name } end
def each
-
(Headers)
- self-reference -
(Enumerator)
- if no block given
def each return to_enum(__method__) unless block_given? @pile.each { |arr| yield(arr) } self end
def get(name)
-
(Array
-)
def get(name) name = normalize_header name.to_s @pile.select { |k, _| k == name }.map { |_, v| v } end
def initialize
def initialize @pile = [] end
def initialize_copy(orig)
- Api: - private
def initialize_copy(orig) super @pile = to_a end
def inspect
-
(String)
-
def inspect "#<#{self.class} #{to_h.inspect}>" end
def keys
-
(Array
-)
def keys @pile.map { |k, _| k }.uniq end
def merge(other)
-
(Headers)
-
Other tags:
- See: #merge! -
def merge(other) dup.tap { |dupped| dupped.merge! other } end
def merge!(other)
-
(void)
-
Other tags:
- See: #merge -
def merge!(other) self.class.coerce(other).to_h.each { |name, values| set name, values } end
def normalize_header(name)
-
(String)
- canonical HTTP header name
Raises:
-
(InvalidHeaderNameError)
- if normalized name does not
Parameters:
-
name
(String
) --
def normalize_header(name) return name if name =~ CANONICAL_NAME_RE normalized = name.split(/[\-_]/).each(&:capitalize!).join("-") return normalized if normalized =~ COMPLIANT_NAME_RE raise InvalidHeaderNameError, "Invalid HTTP header field name: #{name.inspect}" end
def set(name, value)
-
(void)
-
Parameters:
-
(
) --
def set(name, value) delete(name) add(name, value) end
def to_a
-
(Array<[String, String]>)
-
def to_a @pile.map { |pair| pair.map(&:dup) } end
def to_h
-
(Hash)
-
def to_h Hash[keys.map { |k| [k, self[k]] }] end