Takes an array of cookies and returns a string for use in the Cookie header, like "name1=value2; name2=value2".

Parses a Cookie header value into a hash of name-value string pairs. The first appearance takes precedence if multiple pairs with the same name occur.

Creates a cookie object. For each key of `attr_hash`, the setter is called if defined and any error (typically ArgumentError or TypeError) that is raised will be passed through. Each key can be either a downcased symbol or a string that may be mixed case. Support for the latter may, however, be obsoleted in future when Ruby 2.0‘s keyword syntax is adopted.

If `value` is omitted or it is nil, an expiration cookie is created unless `max_age` or `expires` (`expires_at`) is given.

e.g.

    new("uid", "a12345")
    new("uid", "a12345", :domain => 'example.org',
                         :for_domain => true, :expired => Time.now + 7*86400)
    new("name" => "uid", "value" => "a12345", "Domain" => 'www.example.org')

Parses a Set-Cookie header value `set_cookie` assuming that it is sent from a source URI/URL `origin`, and returns an array of Cookie objects. Parts (separated by commas) that are malformed or considered unacceptable are silently ignored.

If a block is given, each cookie object is passed to the block.

Available option keywords are below:

:created_at : The creation time of the cookies parsed.

:logger : Logger object useful for debugging

### Compatibility Note for Mechanize::Cookie users

• Order of parameters changed in HTTP::Cookie.parse:

        Mechanize::Cookie.parse(uri, set_cookie[, log])
  
        HTTP::Cookie.parse(set_cookie, uri[, :logger => # log])
  

• HTTP::Cookie.parse does not accept nil for `set_cookie`.
• HTTP::Cookie.parse does not yield nil nor include nil in an returned array. It simply ignores unparsable parts.
• HTTP::Cookie.parse is made to follow RFC 6265 to the extent not terribly breaking interoperability with broken implementations. In particular, it is capable of parsing cookie definitions containing double-quotes just as naturally expected.

Tests if target_path is under base_path as described in RFC 6265 5.1.4. base_path must be an absolute path. target_path may be empty, in which case it is treated as the root path.

e.g.

        path_match?('/admin/', '/admin/index') == true
        path_match?('/admin/', '/Admin/index') == false
        path_match?('/admin/', '/admin/') == true
        path_match?('/admin/', '/admin') == false

        path_match?('/admin', '/admin') == true
        path_match?('/admin', '/Admin') == false
        path_match?('/admin', '/admins') == false
        path_match?('/admin', '/admin/') == true
        path_match?('/admin', '/admin/index') == true

Compares the cookie with another. When there are many cookies with the same name for a URL, the value of the smallest must be used.

Tests if it is OK to accept this cookie considering its origin. If either domain or path is missing, raises ArgumentError. If origin is missing, returns true.

Tests if it is OK to accept this cookie if it is sent from a given URI/URL, `uri`.

Returns a string for use in the Cookie header, i.e. `name=value` or `name="value"`.

See domain.

Returns the domain, with a dot prefixed only if the domain flag is on.

YAML serialization helper for Psych.

Expires this cookie by setting the expires attribute value to a past date.

Tests if this cookie is expired by now, or by a given time.

See expires.

Alias for expires

Alias for expires=

YAML deserialization helper for Syck.

See max_age.

See name.

See origin.

See path.

Returns a string for use in the Set-Cookie header. If necessary information like a path or domain (when `for_domain` is set) is missing, RuntimeError is raised. It is always the best to set an origin before calling this method.

Alias for cookie_value

YAML serialization helper for Syck.

Tests if it is OK to send this cookie to a given `uri`. A RuntimeError is raised if the cookie‘s domain is unknown.

See value.

YAML deserialization helper for Psych.