class Protocol::HTTP::Cookie

Represents an individual cookie key-value pair.

def self.parse(string)

@returns [Cookie] The parsed cookie.
@parameter string [String] The string to parse.

Parse a string into a cookie. 
def self.parse(string)
	head, *directives = string.split(/\s*;\s*/)
	
	key, value = head.split("=", 2)
	directives = self.parse_directives(directives)
	
	self.new(
		URL.unescape(key),
		URL.unescape(value),
		directives,
	)
end

def self.parse_directives(strings)

@returns [Hash] The hash of directives.
@parameter strings [Array(String)] The list of strings to parse.

Parse a list of strings into a hash of directives. 
def self.parse_directives(strings)
	strings.collect do |string|
		key, value = string.split("=", 2)
		[key, value || true]
	end.to_h
end

def encoded_name

Encode the name of the cookie. 
def encoded_name
	URL.escape(@name)
end

def encoded_value

Encode the value of the cookie. 
def encoded_value
	URL.escape(@value)
end

def initialize(name, value, directives)

@parameter directives [Hash] The directives of the cookie, e.g. `{"path" => "/"}`.
@parameter value [String] The value of the cookie, e.g. "1234".
@parameter name [String] The name of the cookiel, e.g. "session_id".

Initialize the cookie with the given name, value, and directives. 
def initialize(name, value, directives)
	@name = name
	@value = value
	@directives = directives
end

def to_s

@returns [String] The string representation of the cookie.

Convert the cookie to a string. 
def to_s
	buffer = String.new.b
	
	buffer << encoded_name << "=" << encoded_value
	
	if @directives
		@directives.collect do |key, value|
			buffer << ";"
			
			case value
			when String
				buffer << key << "=" << value
			when TrueClass
				buffer << key
			end
		end
	end
	
	return buffer
end