facets 1.4.2 → 1.4.3

data/ProjectInfo

@@ -2,7 +2,7 @@
 
 title    : Facets
 name     : facets
-version  : '1.4.2'
+version  : '1.4.3'
 created  : '2004-12-16'
 status   : Beta/Stable
 
@@ -36,10 +36,14 @@ revision:
 
 # --- TASKS --- #
 
+backup: !!backup
+  dir: ../BACKUP
+
 package: !!package
-  distribute: [ gem, tar.bz2, deb ]
-  dir: ../REL
+  distribute: [ gem, tar.gz ]
+  dir: ../RELEASE
   exclude:
+    - _darcs
     - web/doc/api
 
 roll: !!package
@@ -59,7 +63,7 @@ release: !!release
   project    : facets
   groupid    : 804
   package    : Facets
-  dir        : release
+  dir        : ../RELEASE
 
 extest: !!extest
   files: 'lib/facets/**/*.rb'
@@ -73,6 +77,8 @@ rdoc-core: !!rdoc
   include:
     - 'lib/facets/core/**/*'
     - '[A-Z]*'
+  exclude:
+    - Reapfile
 
 rdoc-more: !!rdoc
   dir: web/doc/api/more
@@ -81,6 +87,8 @@ rdoc-more: !!rdoc
   include:
     - 'lib/facets/more/**/*'
     - '[A-Z]*'
+  exclude:
+    - Reapfile
 
 publish: !!publish
   host: rubyforge.org

data/lib/facets/core/kernel/own.rb

@@ -1,11 +1,11 @@
 
 module Kernel
 
-  # Easy access to an object's "special" class,
+  # Easy access to an object's specialized class,
   # otherwise known as it's metaclass or singleton class.
 
   def own(&blk)
-    (class << self; self; end).class_eval( &blk ) if blk
+    (class << self; self; end).module_eval( &blk ) if blk
     return (class << self; self; end)
   end
 

data/lib/facets/core/kernel/quaclass.rb

@@ -1,12 +1,15 @@
 
 module Kernel
 
-  # Access to an object's "special" class, otherwise
-  # known as it's eigenclass or metaclass or own, etc.
+  # Easy access to an object qua class, otherwise
+  # known as the object's metaclass or singleton class.
   #
-  # One day these names must be reconciled!
+  #     It is what it is.
+  #
+  #               -- transonoma
 
-  def quaclass
+  def quaclass( &block )
+    (class << self; self; end).module_eval(&block) if block
     (class << self; self; end)
   end
   alias_method :__quaclass__, :quaclass

data/lib/facets/core/module/basename.rb

@@ -18,10 +18,10 @@ class Module
   #   m.basename      #=> "Module_0xb7bb0434"
   #
   def basename
-    if self.name
-      self.name.gsub(/^.*::/, '')
+    if name and not name.empty?
+      name.gsub(/^.*::/, '')
     else
-      self.inspect.gsub('#<','').gsub('>','').sub(':', '_')
+      nil #inspect.gsub('#<','').gsub('>','').sub(':', '_')
     end
   end
 

data/lib/facets/more/command.rb

@@ -107,8 +107,16 @@ module Console ; end
 
 class Console::Command
 
-  def self.execute( *args )
-    new.execute( *args )
+  class << self
+    # Starts the command execution.
+
+    def execute( *args )
+      new.execute( *args )
+    end
+
+    # Alias for #execute.
+
+    alias_method :start, :execute
   end
 
   # Do not let this pass through on to

data/lib/facets/more/cookie.rb

@@ -20,6 +20,9 @@
 #
 # == Additional Information
 #
+# I refered to w3m's source to make these classes. Some comments
+# are quoted from it. I'm thanksful for author(s) of it.
+#
 # * w3m homepage:  http://ei5nazha.yz.yamagata-u.ac.jp/~aito/w3m/eng/
 #
 # == Develop Notes
@@ -31,16 +34,18 @@
 # 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
+# Web Namespace
 
-class WebAgent
+class Web
+
+  # == Web::CookieUtils Module
+  #
+  #  -- CookieUtils::head_match?(str1, str2)
+  #  -- CookieUtils::tail_match?(str1, str2)
+  #  -- CookieUtils::domain_match(host, domain)
+  #  -- CookieUtils::total_dot_num(str)
 
   module CookieUtils
 
@@ -75,6 +80,53 @@ class WebAgent
 
   end
 
+  # == Web::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.
+
   class Cookie
     include CookieUtils
 
@@ -225,6 +277,58 @@ class WebAgent
 
   end
 
+  # == Web::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.
+
   class CookieManager
     include CookieUtils
 
@@ -448,118 +552,5 @@ class WebAgent
       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
+end #module Web

data/lib/facets/more/http.rb

@@ -13,7 +13,7 @@
 #
 # == Developers Notes
 #
-#   TODO This an HTTPAccess may be merged?
+#   TODO This and HTTPAccess may be merged?
 
 # Author::    Hiroshi Nakamura
 # Copyright:: Copyright (c) 2000 Hiroshi Nakamura
@@ -22,7 +22,7 @@
 require 'uri'
 require 'time'
 
-# = HTTP Container.
+# = HTTP Container
 #
 # HTTP Module is a contatiner for HTTP related tools.
 # See HTTPAccess.

data/lib/facets/more/httpaccess.rb

@@ -127,7 +127,7 @@ class Client
     @session_manager.agent_name = @agent_name
     @session_manager.from = @from
     @session_manager.ssl_config = @ssl_config
-    @cookie_manager = WebAgent::CookieManager.new
+    @cookie_manager = Web::CookieManager.new
     self.proxy = proxy
   end
 

data/lib/facets/more/paramix.rb

@@ -93,11 +93,13 @@ class Module
     params = args.last.is_a?(Hash) ? args.pop : {}
     args.each do |mod|
       mixin_parameters[mod] = params
-      define_method( mod.basename ) do |key|
-        if params.key?(key)
-          params[key]
-        else
-          super if defined?( super )
+      if mod.basename
+        define_method( mod.basename ) do |key|
+          if params.key?(key)
+            params[key]
+          else
+            super if defined?( super )
+          end
         end
       end
     end
@@ -117,11 +119,13 @@ class Module
     args.each do |mod|
       (class << self; self; end).class_eval do
         mixin_parameters[mod] = params
-        define_method( mod.basename ) do |key|
-          if params.key?(key)
-            params[key]
-          else
-            super if defined?( super )
+        if mod.basename
+          define_method( mod.basename ) do |key|
+            if params.key?(key)
+              params[key]
+            else
+              super if defined?( super )
+            end
           end
         end
       end