facets 1.3.3 → 1.4.0

data/lib/facets/more/classinherit.rb

@@ -1,34 +1,25 @@
-#--
-# ClassInherit
+# = classinherit.rb
 #
-# Copyright (c) 2005 Thomas Sawyer
+# == Copyright (c) 2005 Thomas Sawyer
 #
-# Ruby License
+#   Ruby License
 #
-# This module is free software. You may use, modify, and/or redistribute this
-# software under the same terms as Ruby.
+#   This module is free software. You may use, modify, and/or redistribute this
+#   software under the same terms as Ruby.
 #
-# This program is distributed in the hope that it will be useful, but WITHOUT
-# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-# FOR A PARTICULAR PURPOSE.
+#   This program is distributed in the hope that it will be useful, but WITHOUT
+#   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+#   FOR A PARTICULAR PURPOSE.
 #
-# ==========================================================================
-#  REVISION HISTORY
-# ==========================================================================
-#  2005-11-29 trans
-#    Version "2.0". Improved by adopting old #class_inherit functionality
-#    as well, i.e. ClassInherit module now will be inherited down
-#    the Hierarchy chain.
+# == Authors and Contributors
 #
-#  2005-04-28 trans
-#    Reimplemented for Calibre based on Nabu's ClassMethods work.
-# ==========================================================================
-#
-# CREDIT Credit is due Nobu and Ulysses.
-#
-#++
+# * Thomas Sawyer
+
+# Author::    Thomas Sawyer
+# Copyright:: Copyright (c) 2005 Thomas Sawyer
+# License::   Ruby License
 
-#:title: ClassInherit
+# = ClassInherit
 #
 # This framework provides a very convenient way to have modules
 # pass along class methods in the inheritance chain.
@@ -105,13 +96,6 @@
 # And making non-inheritance the exception, which is alwasy easy
 # enough to achieve: just put the code in a separate
 # (and thus uninherited) module.
-#
-# == Author(s)
-#
-# * Thomas Sawyer
-# * Nobu Nakada
-# * Ulysses
-#
 
 class Module
 

data/lib/facets/more/classmethods.rb

@@ -1,34 +1,31 @@
-#--
-# ClassMethods
+# = classmethods.rb
 #
-# Copyright (c) 2005 Thomas Sawyer
+# == Copyright (c) 2005 Nobu Nakada, Thomas Sawyer
 #
-# Ruby License
+#   Ruby License
 #
-# This module is free software. You may use, modify, and/or redistribute this
-# software under the same terms as Ruby.
+#   This module is free software. You may use, modify, and/or redistribute this
+#   software under the same terms as Ruby.
 #
-# This program is distributed in the hope that it will be useful, but WITHOUT
-# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-# FOR A PARTICULAR PURPOSE.
+#   This program is distributed in the hope that it will be useful, but WITHOUT
+#   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+#   FOR A PARTICULAR PURPOSE.
 #
-# ==========================================================================
-#  REVISION HISTORY
-# ==========================================================================
-#  2005-11-29 trans
-#  Version "2.0". Improved by adopting old #class_inherit functionality
-#  as well, i.e. ClassMethods module now will be inherited down
-#  the Hierarchy chain.
+# == Special Thanks
 #
-#  2005-04-28 trans
-#  Reimplemented for Calibre based on Nabu's work.
-# ==========================================================================
+# Thanks to Nobu and Ulysses for their original work on this.
 #
-# CREDIT Credit is due Nobu and Ulysses.
+# == Authors and Contributors
 #
-#++
+# * Nobu Nakada
+# * Thomas Sawyer
+# * Ulysses
 
-#:title: ClassMethods
+# Author::    Nobu Nakada, Thomas Sawyer
+# Copyright:: Copyright (c) 2005 Nobu Nakada, Thomas Sawyer
+# License::   Ruby License
+
+# = ClassMethods
 #
 # Miniframework provides a very convenient way to have modules
 # pass along class methods in the inheritance chain.
@@ -105,13 +102,6 @@
 # And making non-inheritance the exception, which is alwasy easy
 # enough to achieve: put the code in a separate (and thus uninherited)
 # module.
-#
-# == Author(s)
-#
-# * Thomas Sawyer
-# * Nobu Nakada
-# * Ulysses
-#
 
 class Module
 

data/lib/facets/more/cloneable.rb

@@ -1,42 +1,54 @@
-#--
-# Cloneable (ported from Rake)
-#
-# Copyright (c) 2003, 2004 Jim Weirich
-#
-# Permission is hereby granted, free of charge, to any person obtaining
-# a copy of this software and associated documentation files (the
-# "Software"), to deal in the Software without restriction, including
-# without limitation the rights to use, copy, modify, merge, publish,
-# distribute, sublicense, and/or sell copies of the Software, and to
-# permit persons to whom the Software is furnished to do so, subject to
-# the following conditions:
-#
-# The above copyright notice and this permission notice shall be
-# included in all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-#++
+# = cloneable.rb
+#
+# == Copyright (c) 2003-2004 Jim Weirich
+#
+#   GNU General Public License (GPL)
+#
+#   Permission is hereby granted, free of charge, to any person obtaining
+#   a copy of this software and associated documentation files (the
+#   "Software"), to deal in the Software without restriction, including
+#   without limitation the rights to use, copy, modify, merge, publish,
+#   distribute, sublicense, and/or sell copies of the Software, and to
+#   permit persons to whom the Software is furnished to do so, subject to
+#   the following conditions:
+#
+#   The above copyright notice and this permission notice shall be
+#   included in all copies or substantial portions of the Software.
+#
+#   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+#   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+#   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+#   NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+#   LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+#   OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+#   WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+# == Speical Thanks
+#
+# Cloneable was ported from Jim Weirich's Rake.
+#
+# == Authors and Contributors
+#
+# * Jim Weirich
+#
+# == Developer Notes
+#
+#   TODO Method #clone should copy '<<'-methods in contrast to #dup.
+
+# Author::    Jim Weirich
+# Copyright:: Copyright (c) 2002 Jim Weirich
+# License::   GNU General Public License (GPL)
 
-# :title: Cloneable
+# = Cloneable
 #
 # Stadard basis for adding #dup and #clone methods to a class.
-#
-#--
-# TODO #clone should copy '<<'-methods in contrast to #dup.
-#++
 
 module Cloneable
   def clone
     sibling = self.class.new
     instance_variables.each do |ivar|
       value = self.instance_variable_get(ivar)
-      sibling.instance_variable_set(ivar, value.rake_dup)
+      sibling.instance_variable_set(ivar, value.dup) #rake_dup)
     end
     sibling
   end

data/lib/facets/more/consoleapp.rb

@@ -1,31 +1,44 @@
-#--
-# Console Applicaiton
+# = consoleapp.rb
 #
-# Copyright (c) 2005, Thomas Sawyer
+# == Copyright (c) 2005 Thomas Sawyer
 #
-# Ruby License
+#   Ruby License
 #
-# This module is free software. You may use, modify, and/or
-# redistribute this software under the same terms as Ruby.
+#   This module is free software. You may use, modify, and/or
+#   redistribute this software under the same terms as Ruby.
 #
-# This program is distributed in the hope that it will be
-# useful, but WITHOUT ANY WARRANTY; without even the implied
-# warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
-# PURPOSE.
+#   This program is distributed in the hope that it will be
+#   useful, but WITHOUT ANY WARRANTY; without even the implied
+#   warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+#   PURPOSE.
 #
-# =============================================================
-#  HISTORY
-# -------------------------------------------------------------
-#  2005-09-09 Trans  * Created.
-# =============================================================
+# == Author(s)
 #
-# TODO Add documentation features.
+# * Thomas Sawyer
 #
-#++
+# == Developer Notes
+#
+#   TODO Add documentation features.
+#
+#   TODO Rename file to consolecmd.rb or consolecommand.rb,
+#        or move to console/command.rb, but I'm not sure yet if
+#        adding subdirectories to more/ is a good idea.
+#
+#   TODO Also, probably should deprecate Console::Application
+#        alias at some point.
+
+# Author::    Thomas Sawyer
+# Copyright:: Copyright (c) 2005 Thomas Sawyer
+# License::   Ruby License
+
+# = Console
+#
+# Console namespace for use by tools specifically designed
+# for command line interfaces.
 
 module Console ; end
 
-#:title: Console Command
+# = Console Command
 #
 # Console::Command provides a clean and easy way
 # to create a command line interface for your program.
@@ -69,13 +82,20 @@ module Console ; end
 
 class Console::Command
 
-  def execute( argv=nil )
+  def self.execute( *args )
+    new.execute( *args )
+  end
+
+  def initialize
+    # do not let this pass through on to
+    # any included module.
+  end
 
+  def execute( argv=nil )
     argv ||= ARGV      # argv remains unchanged
     args = argv.dup    # args is manipulated
 
     # process options
-
     i = 0;
     while i < argv.size
       if md = %r{^[-]}.match( argv[i] )
@@ -140,8 +160,8 @@ class Console::Command
   end
 
   alias_method :go, :execute
-  
+
 end
 
-# temporary backward compatability
+# backward compatability
 Console::Application = Console::Command

data/lib/facets/more/cookie.rb

@@ -0,0 +1,565 @@
+# = cookie.rb
+#
+# == Copyright (c) 2004 TAKAHASHI `Maki' Masayoshi
+#
+#   Ruby License
+#
+#   This module is free software. You may use, modify, and/or redistribute this
+#   software under the same terms as Ruby.
+#
+#   This program is distributed in the hope that it will be useful, but WITHOUT
+#   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+#   FOR A PARTICULAR PURPOSE.
+#
+# == Special Thanks
+#
+# cookie.rb is redistributed file which is originally included in Webagent
+# version 0.6.2 by TAKAHASHI `Maki' Masayoshi. And it contains some bug fixes.
+# You can download the entire package of Webagent from:
+# * http://www.rubycolor.org/arc/.
+#
+# == Additional Information
+#
+# * w3m homepage:  http://ei5nazha.yz.yamagata-u.ac.jp/~aito/w3m/eng/
+#
+# == Develop Notes
+#
+#   TODO Remove from WebAgent contatiner,
+#        Perhaps move to HTTP containter.
+
+# Author::    TAKAHASHI `Maki' Masayoshi
+# Copyright:: Copyright (c) 2004 TAKAHASHI `Maki' Masayoshi
+# License::   Ruby License
+
+# = Cookie
+#
+# I refered to w3m's source to make these classes. Some comments
+# are quoted from it. I'm thanksful for author(s) of it.
+
+require 'uri'
+
+# WebAgent
+
+class WebAgent
+
+  module CookieUtils
+
+    def head_match?(str1, str2)
+      str1 == str2[0, str1.length]
+    end
+
+    def tail_match?(str1, str2)
+      if str1.length > 0
+        str1 == str2[-str1.length..-1].to_s
+      else
+        true
+      end
+    end
+
+    def domain_match(host, domain)
+      case domain
+      when /\d+\.\d+\.\d+\.\d+/
+        return (host == domain)
+      when '.'
+        return true
+      when /^\./
+        return tail_match?(domain, host)
+      else
+        return (host == domain)
+      end
+    end
+
+    def total_dot_num(string)
+      string.scan(/\./).length()
+    end
+
+  end
+
+  class Cookie
+    include CookieUtils
+
+    require 'parsedate'
+    include ParseDate
+
+    attr_accessor :name, :value
+    attr_accessor :domain, :path
+    attr_accessor :expires      ## for Netscape Cookie
+    attr_accessor :url
+    attr_writer :use, :secure, :discard, :domain_orig, :path_orig, :override
+
+    USE = 1
+    SECURE = 2
+    DOMAIN = 4
+    PATH = 8
+    DISCARD = 16
+    OVERRIDE = 32
+    OVERRIDE_OK = 32
+
+    def initialize()
+      @discard = @use = @secure = @domain_orig = @path_orig = @override = nil
+    end
+
+    def discard?
+      @discard
+    end
+
+    def use?
+      @use
+    end
+
+    def secure?
+      @secure
+    end
+
+    def domain_orig?
+      @domain_orig
+    end
+
+    def path_orig?
+      @path_orig
+    end
+
+    def override?
+      @override
+    end
+
+    def flag
+      flg = 0
+      flg += USE  if @use
+      flg += SECURE  if @secure
+      flg += DOMAIN  if @domain_orig
+      flg += PATH  if @path_orig
+      flg += DISCARD if @discard
+      flg += OVERRIDE if @override
+      flg
+    end
+
+    def set_flag(flag)
+      flag = flag.to_i
+      @use = true      if flag & USE > 0
+      @secure = true   if flag & SECURE > 0
+      @domain_orig = true if flag & DOMAIN > 0
+      @path_orig = true if flag & PATH > 0
+      @discard  = true if flag & DISCARD > 0
+      @override = true if flag & OVERRIDE > 0
+    end
+
+    def match?(url)
+      domainname = url.host
+      if (!domainname ||
+          !domain_match(domainname, @domain) ||
+          (@path && !head_match?(@path, url.path)) ||
+          (@secure && (url.scheme != 'https')) )
+        return false
+      else
+        return true
+      end
+    end
+
+    def join_quotedstr(array, sep)
+      ret = Array.new()
+      old_elem = nil
+      array.each{|elem|
+        if (elem.scan(/"/).length % 2) == 0
+          if old_elem
+            old_elem << sep << elem
+          else
+            ret << elem
+            old_elem = nil
+          end
+        else
+          if old_elem
+            old_elem << sep << elem
+            ret << old_elem
+            old_elem = nil
+          else
+            old_elem = elem.dup
+          end
+        end
+      }
+      ret
+    end
+
+    def parse(str, url)
+      @url = url
+      cookie_elem = str.split(/;/)
+      cookie_elem = join_quotedstr(cookie_elem, ';')
+      first_elem = cookie_elem.shift
+      if first_elem !~ /([^=]*)(\=(.*))?/
+        return
+        ## raise ArgumentError 'invalid cookie value'
+      end
+      @name = $1.strip
+      @value = $3
+      if @value
+        if @value =~ /^\s*"(.*)"\s*$/
+          @value = $1
+        else
+          @value.dup.strip!
+        end
+      end
+      cookie_elem.each{|pair|
+        key, value = pair.split(/=/)  ## value may nil
+        key.strip!
+        if value
+          value = value.strip.sub(/\A"(.*)"\z/) { $1 }
+        end
+        case key.downcase
+        when 'domain'
+          @domain = value
+        when 'expires'
+          begin
+            @expires = Time.gm(*parsedate(value)[0,6])
+          rescue ArgumentError
+            @expires = nil
+          end
+        when 'path'
+          @path = value
+        when 'secure'
+          @secure = true  ## value may nil, but must 'true'.
+        else
+          ## ignore
+        end
+      }
+    end
+
+  end
+
+  class CookieManager
+    include CookieUtils
+
+    ### errors
+    class Error < StandardError; end
+    class ErrorOverrideOK < Error; end
+    class SpecialError < Error; end
+    class NoDotError < ErrorOverrideOK; end
+
+    SPECIAL_DOMAIN = [".com",".edu",".gov",".mil",".net",".org",".int"]
+
+    attr_accessor :cookies
+    attr_accessor :cookies_file
+    attr_accessor :accept_domains, :reject_domains
+    attr_accessor :netscape_rule
+
+    def initialize(file=nil)
+      @cookies = Array.new()
+      @cookies_file = file
+      @is_saved = true
+      @reject_domains = Array.new()
+      @accept_domains = Array.new()
+      # for conformance to http://wp.netscape.com/newsref/std/cookie_spec.html
+      @netscape_rule = false
+    end
+
+    def save_all_cookies(force = nil, save_unused = true, save_discarded = true)
+      if @is_saved and !force
+        return
+      end
+      File.open(@cookies_file, 'w') do |f|
+        @cookies.each do |cookie|
+          if (cookie.use? or save_unused) and
+              (!cookie.discard? or save_discarded)
+            f.print(cookie.url.to_s,"\t",
+                    cookie.name,"\t",
+                    cookie.value,"\t",
+                    cookie.expires.to_i,"\t",
+                    cookie.domain,"\t",
+                    cookie.path,"\t",
+                    cookie.flag,"\n")
+          end
+        end
+      end
+    end
+
+    def save_cookies(force = nil)
+      save_all_cookies(force, false, false)
+    end
+
+    def check_expired_cookies()
+      @cookies.reject!{|cookie|
+        is_expired = (cookie.expires && (cookie.expires < Time.now.gmtime))
+        if is_expired && !cookie.discard?
+          @is_saved = false
+        end
+        is_expired
+      }
+    end
+
+    def parse(str, url)
+      cookie = WebAgent::Cookie.new()
+      cookie.parse(str, url)
+      add(cookie)
+    end
+
+    def make_cookie_str(cookie_list)
+      if cookie_list.empty?
+        return nil
+      end
+
+      ret = ''
+      c = cookie_list.shift
+      ret += "#{c.name}=#{c.value}"
+      cookie_list.each{|cookie|
+        ret += "; #{cookie.name}=#{cookie.value}"
+      }
+      return ret
+    end
+    private :make_cookie_str
+
+
+    def find(url)
+
+      check_expired_cookies()
+
+      cookie_list = Array.new()
+
+      @cookies.each{|cookie|
+        if cookie.use? && cookie.match?(url)
+          if cookie_list.select{|c1| c1.name == cookie.name}.empty?
+            cookie_list << cookie
+          end
+        end
+      }
+      return make_cookie_str(cookie_list)
+    end
+
+    def find_cookie_info(domain, path, name)
+      @cookies.find{|c|
+        c.domain == domain && c.path == path && c.name == name
+      }
+    end
+    private :find_cookie_info
+
+    def cookie_error(err, override)
+      if err.kind_of?(ErrorOverrideOK) || !override
+        raise err
+      end
+    end
+    private :cookie_error
+
+    def add(cookie)
+      url = cookie.url
+      name, value = cookie.name, cookie.value
+      expires, domain, path = 
+        cookie.expires, cookie.domain, cookie.path
+      secure, domain_orig, path_orig = 
+        cookie.secure?, cookie.domain_orig?, cookie.path_orig?
+      discard, override = 
+        cookie.discard?, cookie.override?
+
+      domainname = url.host
+      domain_orig, path_orig = domain, path
+      use_security = override
+
+      if !domainname
+        cookie_error(NodotError.new(), override)
+      end
+
+      if domain
+
+        # [DRAFT 12] s. 4.2.2 (does not apply in the case that
+        # host name is the same as domain attribute for version 0
+        # cookie)
+        # I think that this rule has almost the same effect as the
+        # tail match of [NETSCAPE].
+        if domain !~ /^\./ && domainname != domain
+          domain = '.'+domain
+        end
+
+        n = total_dot_num(domain)
+        if n < 2
+          cookie_error(SpecialError.new(), override)
+        elsif @netscape_rule and n == 2
+          ## [NETSCAPE] rule
+          ok = SPECIAL_DOMAIN.select{|sdomain|
+            sdomain == domain[-(sdomain.length)..-1]
+          }
+          if ok.empty?
+            cookie_error(SpecialError.new(), override)
+          end
+        end
+
+      end
+
+      path ||= url.path.sub!(%r|/[^/]*|, '')
+      domain ||= domainname
+      cookie = find_cookie_info(domain, path, name)
+
+      if !cookie
+        cookie = WebAgent::Cookie.new()
+        cookie.use = true
+        @cookies << cookie
+      end
+
+      cookie.url = url
+      cookie.name = name
+      cookie.value = value
+      cookie.expires = expires
+      cookie.domain = domain
+      cookie.path = path
+
+      ## for flag
+      cookie.secure = secure
+      cookie.domain_orig = domain_orig
+      cookie.path_orig = path_orig
+      if discard || cookie.expires == nil
+        cookie.discard = true
+      else
+        cookie.discard = false
+        @is_saved = false
+      end
+
+      check_expired_cookies()
+      return false
+    end
+
+    def load_cookies()
+      return if !File.readable?(@cookies_file)
+      File.open(@cookies_file,'r'){|f|
+        while line = f.gets
+          cookie = WebAgent::Cookie.new()
+          @cookies << cookie
+          col = line.chomp.split(/\t/)
+          cookie.url = URI.parse(col[0])
+          cookie.name = col[1]
+          cookie.value = col[2]
+          cookie.expires = Time.at(col[3].to_i)
+          cookie.domain = col[4]
+          cookie.path = col[5]
+          cookie.set_flag(col[6])
+        end
+      }
+    end
+
+    def check_cookie_accept_domain(domain)
+      unless domain
+        return false
+      end
+      @accept_domains.each{|dom|
+        if domain_match(domain, dom)
+          return true
+        end
+      }
+      @reject_domains.each{|dom|
+        if domain_match(domain, dom)
+          return false
+        end
+      }
+      return true
+    end
+  end
+end
+
+__END__
+
+=begin
+
+== WebAgent::CookieManager Class
+
+Load, save, parse and send cookies.
+
+=== Usage
+
+  ## initialize
+  cm = WebAgent::CookieManager.new("/home/foo/bar/cookie")
+
+  ## load cookie data
+  cm.load_cookies()
+
+  ## parse cookie from string (maybe "Set-Cookie:" header)
+  cm.parse(str)
+
+  ## send cookie data to url
+  f.write(cm.find(url))
+
+  ## save cookie to cookiefile
+  cm.save_cookies()
+
+
+=== Class Methods
+
+ -- CookieManager::new(file=nil)
+
+     create new CookieManager. If a file is provided,
+     use it as cookies' file.
+
+=== Methods
+
+ -- CookieManager#save_cookies(force = nil)
+
+     save cookies' data into file. if argument is true,
+     save data although data is not modified.
+
+ -- CookieManager#parse(str, url)
+
+     parse string and store cookie (to parse HTTP response header).
+
+ -- CookieManager#find(url)
+
+     get cookies and make into string (to send as HTTP request header).
+
+ -- CookieManager#add(cookie)
+
+     add new cookie.
+
+ -- CookieManager#load_cookies()
+
+     load cookies' data from file.
+
+
+== WebAgent::CookieUtils Module
+
+ -- CookieUtils::head_match?(str1, str2)
+ -- CookieUtils::tail_match?(str1, str2)
+ -- CookieUtils::domain_match(host, domain)
+ -- CookieUtils::total_dot_num(str)
+
+
+== WebAgent::Cookie Class
+
+=== Class Methods
+
+ -- Cookie::new()
+
+      create new cookie.
+
+=== Methods
+
+ -- Cookie#match?(url)
+
+       match cookie by url. if match, return true. otherwise,
+       return false.
+
+ -- Cookie#name
+ -- Cookie#name=(name)
+ -- Cookie#value
+ -- Cookie#value=(value)
+ -- Cookie#domain
+ -- Cookie#domain=(domain)
+ -- Cookie#path
+ -- Cookie#path=(path)
+ -- Cookie#expires
+ -- Cookie#expires=(expires)
+ -- Cookie#url
+ -- Cookie#url=(url)
+
+      accessor methods for cookie's items.
+
+ -- Cookie#discard?
+ -- Cookie#discard=(discard)
+ -- Cookie#use?
+ -- Cookie#use=(use)
+ -- Cookie#secure?
+ -- Cookie#secure=(secure)
+ -- Cookie#domain_orig?
+ -- Cookie#domain_orig=(domain_orig)
+ -- Cookie#path_orig?
+ -- Cookie#path_orig=(path_orig)
+ -- Cookie#override?
+ -- Cookie#override=(override)
+ -- Cookie#flag
+ -- Cookie#set_flag(flag_num)
+
+      accessor methods for flags.
+
+=end