facets 2.4.0 → 2.4.1

data/doc/html/api/more/files/NOTES.html

@@ -63,7 +63,7 @@
           </tr>
           <tr>
             <td>Modified:</td>
-            <td>Tue Mar 18 09:42:14 -0400 2008</td>
+            <td>Mon Mar 24 19:07:26 -0400 2008</td>
           </tr>
         </table>
       </td></tr>
@@ -77,34 +77,65 @@
 
   <div class="description"><h1>Release Notes</h1>
 <p>
-Facets 2.3 makes some nice internal reorganization, rather then just the
-split between core/ and more/, we have added class/ and mixin/. This helps
-a great deal in working with the library. If does not effect the end-user
-in anyway however &#8212;even so we felt it enough to warrent a minor
-version bump rather than just a tiny.
+Facets 2.4 is a major step forward for Facets. <a
+href="../classes/It.html">It</a> is perhaps the release that 2.0 should
+have been, but of course it took the actual 2.0 release to make 2.4
+possible. Some annoyances you may have encountered in updating your code to
+2.0 are now fixed. And from 2.4 on, Facets will now be settling down into
+simple refinement release cycles.
 </p>
 <p>
-Amoung other changes with this release, cloneable.rb is now a true deep
-dup/clone mixin; tracepoint.rb returns to the library; and &#8230;
+The main change under the hood is to bring everything up to the top
+lib/facets/ directory. No longer are the libraries sorted by category. I
+had done so for a long time to make it easier to track the various libs,
+but in the end it was only making it more diffcult to deal with build tools
+and packaging.
 </p>
 <p>
-As of 2.2.1:
+For the end-user, the largest change is a new emphisis on:
 </p>
+<pre>
+  require 'facets'
+</pre>
 <p>
-This release get rid of the underlying methods subdir. All method redirects
-are now in core, to ensure there are no more name clashes.
+This is better than cherry-picking methods. <a
+href="../classes/It.html">It</a> may seem counter- intuitive, but it
+actually proves more advantantages to do this for the sake of
+interoperability than the practice of cherry-picking. The reason is simply
+because others may have cherry-picked different methods, and those
+distinctions go unaccounted and untested.
+</p>
+<p>
+Also with this release, to bolster the use of require &#8216;facets&#8217;,
+some lack-luster extensions have been deprecated and namespace usage has
+been improved. In addition, we are getting very close to full
+ActiveSupport, and Ruby 1.9, interoperability. Expect this to be complete
+in the next minor release or two.
+</p>
+<p>
+This is still a bit of an early release. There remain a few libraries to
+adjust for the new design considerations, but I wanted to get this new
+design out as soon as possible so others could adjust their code sooner
+rather than later. I&#8216;ll be catching up on the CHANGES list over the
+next few minor release.
 </p>
+<h2>As of 2.3</h2>
 <p>
-As of 2.2.0:
+Amoung other changes with this release, cloneable.rb is now a true deep
+dup/clone mixin; tracepoint.rb returns to the library.
 </p>
+<h2>As of 2.2.1:</h2>
+<p>
+This release get rid of the underlying methods subdir. All method redirects
+are now in core, to ensure there are no more name clashes.
+</p>
+<h2>As of 2.2.0:</h2>
 <p>
 This release provides improved rdocs and prepares facets for use with RUby
 1.9. <a href="../classes/It.html">It</a> also adds Matthew Harris&#8217;
 duration.rb library. Bug thanks to Matthew!
 </p>
-<p>
-As of 2.1.0:
-</p>
+<h2>As of 2.1.0:</h2>
 <p>
 Major changes include a new and much-improved command.rb, a new <a
 href="../classes/BiCrypt.html">BiCrypt</a> class for simple two-way

data/doc/html/changes.html

@@ -8,10 +8,22 @@
           <div class="content">
           <div class="main">
             <h1>Change History</h1>
-<h2>2.4.0 / 2008-02-27</h2>
+<h2>2.4.0 / 2008-03-24</h2>
 <ul>
-<li>threaded.rb, map_send, et al, block is passed to send instead of yiedling
-on result.
+<li>The Console name space is being deprecated. command.rb and arguments.rb now
+use CLI naemspace.
+
+</li>
+<li>#compare_on and #equate_on are now &quot;mixin methods&quot; Comparable()
+and Equateable().
+
+</li>
+<li>Enumerable#product, #combintations and #permutations have change to be Ruby
+1.9 compatible.
+
+</li>
+<li>thread.rb, map_send, et al, block is passed to send instead of yiedling on
+result.
 
 </li>
 <li>namespace.rb has been renamed to methodspace.rb.
@@ -34,6 +46,10 @@ application&quot;.
 <li>Brought back a few web related libs htmlfilter.rb and cssfilter.rb in
 particular.
 
+</li>
+<li>This was a fairly large and fast-paced update, so not all changes are
+listed. See RDocs to more information.
+
 </li>
 </ul>
 <h2>2.3.0 / 2008-02-01</h2>

data/doc/html/notes.html

@@ -9,34 +9,63 @@
           <div class="main">
             <h1>Release Notes</h1>
 <p>
-Facets 2.3 makes some nice internal reorganization, rather then just the
-split between core/ and more/, we have added class/ and mixin/. This helps
-a great deal in working with the library. If does not effect the end-user
-in anyway however &#8212;even so we felt it enough to warrent a minor
-version bump rather than just a tiny.
+Facets 2.4 is a major step forward for Facets. It is perhaps the release
+that 2.0 should have been, but of course it took the actual 2.0 release to
+make 2.4 possible. Some annoyances you may have encountered in updating
+your code to 2.0 are now fixed. And from 2.4 on, Facets will now be
+settling down into simple refinement release cycles.
 </p>
 <p>
-Amoung other changes with this release, cloneable.rb is now a true deep
-dup/clone mixin; tracepoint.rb returns to the library; and &#8230;
+The main change under the hood is to bring everything up to the top
+lib/facets/ directory. No longer are the libraries sorted by category. I
+had done so for a long time to make it easier to track the various libs,
+but in the end it was only making it more diffcult to deal with build tools
+and packaging.
 </p>
 <p>
-As of 2.2.1:
+For the end-user, the largest change is a new emphisis on:
 </p>
+<pre>
+  require 'facets'
+</pre>
 <p>
-This release get rid of the underlying methods subdir. All method redirects
-are now in core, to ensure there are no more name clashes.
+This is better than cherry-picking methods. It may seem counter- intuitive,
+but it actually proves more advantantages to do this for the sake of
+interoperability than the practice of cherry-picking. The reason is simply
+because others may have cherry-picked different methods, and those
+distinctions go unaccounted and untested.
+</p>
+<p>
+Also with this release, to bolster the use of require &#8216;facets&#8217;,
+some lack-luster extensions have been deprecated and namespace usage has
+been improved. In addition, we are getting very close to full
+ActiveSupport, and Ruby 1.9, interoperability. Expect this to be complete
+in the next minor release or two.
+</p>
+<p>
+This is still a bit of an early release. There remain a few libraries to
+adjust for the new design considerations, but I wanted to get this new
+design out as soon as possible so others could adjust their code sooner
+rather than later. I&#8217;ll be catching up on the CHANGES list over the
+next few minor release.
 </p>
+<h2>As of 2.3</h2>
 <p>
-As of 2.2.0:
+Amoung other changes with this release, cloneable.rb is now a true deep
+dup/clone mixin; tracepoint.rb returns to the library.
 </p>
+<h2>As of 2.2.1:</h2>
+<p>
+This release get rid of the underlying methods subdir. All method redirects
+are now in core, to ensure there are no more name clashes.
+</p>
+<h2>As of 2.2.0:</h2>
 <p>
 This release provides improved rdocs and prepares facets for use with RUby
 1.9. It also adds Matthew Harris&#8217; duration.rb library. Bug thanks to
 Matthew!
 </p>
-<p>
-As of 2.1.0:
-</p>
+<h2>As of 2.1.0:</h2>
 <p>
 Major changes include a new and much-improved command.rb, a new BiCrypt
 class for simple two-way crypotgraphy, as well as attr_reader!,

data/doc/notes.rdoc

@@ -0,0 +1,9 @@
+== Instance Prefixed Methods
+
+Kernel extension prefixed by instance_ which provide
+internal (eg private) access to the object.
+Kernel extension using instance_ prefix which is beneficial
+to separation of metaprogramming from general programming.
+object_ methods, in contrast to the instance_ methods,
+do not access internal state.
+

data/lib/facets/basex.rb

@@ -0,0 +1,37 @@
+class BaseX
+
+  BASE62 = ["0".."9", "a".."z", "A".."Z"].map { |r| r.to_a }.flatten
+
+  attr :chars, :base, :values
+
+  def initialize(chars=BASE62)
+    @chars  = chars
+    @base   = @chars.size
+    @values = Hash[*(0...@base).map { |i| [ @chars[i], i ] }.flatten]
+  end
+
+  def encode(byte_string)
+    convert_base(byte_string.unpack("C*"), 256, @base).map { |d|
+      @chars[d]
+    }.join('')
+  end
+
+  def decode(encoded)
+    convert_base(encoded.split('').map { |c|
+      @values[c]
+    }, @base, 256).pack("C*")
+  end
+
+  def convert_base(digits, from_base, to_base)
+    bignum = 0
+    digits.each { |digit| bignum = bignum * from_base + digit }
+    converted = []
+    until bignum.zero?
+      bignum, digit = bignum.divmod to_base
+      converted.push digit
+    end
+    converted.reverse
+  end
+
+end
+

data/lib/facets/basicobject.rb

@@ -66,7 +66,7 @@
 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 # FOR A PARTICULAR PURPOSE.
 
-require 'facets/kernel/object'
+require 'facets/kernel/object_class'
 require 'facets/kernel/as'
 
 # = BasicObject
@@ -122,7 +122,7 @@ class BasicObject
   def object_self
     @__object_self__ ||= As.new(self, ::Object)
   end
-  alias :__self__ :object_self  # deprecate
+  alias :__self__ :object_self
 
 #--
   # The Self class allows one to get access the hidden Object/Kernel methods.

data/lib/facets/date.rb

@@ -20,6 +20,7 @@
 #   FOR A PARTICULAR PURPOSE.
 
 require 'date'
+require 'parsedate' # needed for String#to_date
 
 class Date
 
@@ -55,9 +56,8 @@ class Date
   #
   #   Date.new(2004,2).days_in_month #=> 28
   #
-  #--
-  # Credit goes to Ken Kunz.
-  #++
+  #  CREDIT: Ken Kunz.
+
   def days_in_month
      Date.civil(year, month, -1).day
   end
@@ -68,7 +68,7 @@ class Date
 
   # Get the month name for this date object
   #
-  # CREDIT Benjamin Oakes
+  #  CREDIT Benjamin Oakes
 
   def month_name
     MONTHNAMES[self.month]
@@ -76,3 +76,15 @@ class Date
 
 end
 
+class String
+
+  # Parse data from string.
+  #
+  #  CREDIT: Trans
+
+  def to_date
+    ::Date::civil(*ParseDate.parsedate(self)[0..2])
+  end
+
+end
+

data/lib/facets/exception.rb

@@ -1 +1,2 @@
 require 'facets/exception/detail.rb'
+require 'facets/exception/suppress.rb'

data/lib/facets/exception/suppress.rb

@@ -0,0 +1,21 @@
+class Exception
+
+  # Supress errors while executing a block, with execptions.
+  #
+  #  CREDIT: Trans
+  #  CREDIT: David Heinemeier Hansson
+
+  def self.suppress(*exception_classes)
+    exception_classes.each do |e|
+      unless e < self
+        raise ArgumentError, "exception #{e} not a subclass of #{self}"
+      end
+    end
+    begin yield
+    rescue Exception => e
+      raise unless exception_classes.any? { |cls| e.kind_of?(cls) }
+    end
+  end
+
+end
+

data/lib/facets/hash/argumentize.rb

@@ -4,7 +4,8 @@ class Hash
   #
   #   h = { :list => [1,2], :base => "HI" }
   #   h.argumentize #=> [ [], { :list => [1,2], :base => "HI" } ]
-  #   h.argumentize(:list) #=> [ [1,2], { :base => "HI" } ]
+  #   h.argumentize(:list)   #=> [ [1,2], { :base => "HI" } ]
+  #   h.argumentize(:base)   #=> [ ["HI"], { :list => [1,2] } ]
   #
   def argumentize(args_field=nil)
     config = dup

data/lib/facets/kernel.rb

@@ -1,6 +1,8 @@
 require 'facets/ruby'
 
 require 'facets/kernel/__dir__.rb'
+require 'facets/kernel/__get__.rb'
+require 'facets/kernel/__set__.rb'
 require 'facets/kernel/as.rb'
 require 'facets/kernel/complete.rb'
 require 'facets/kernel/constant.rb'
@@ -8,15 +10,20 @@ require 'facets/kernel/d.rb'
 require 'facets/kernel/deep_copy.rb'
 require 'facets/kernel/ergo.rb'
 require 'facets/kernel/here.rb'
-require 'facets/kernel/instance.rb'
+require 'facets/kernel/instance_assign.rb' # DEPRECATE
+require 'facets/kernel/instance_class.rb'
+require 'facets/kernel/instance_send.rb'
 require 'facets/kernel/load.rb'
 require 'facets/kernel/not_nil.rb'
-require 'facets/kernel/object.rb'
+require 'facets/kernel/object_class.rb'
+require 'facets/kernel/object_hexid.rb'
+require 'facets/kernel/object_send.rb'
 require 'facets/kernel/p.rb'
 require 'facets/kernel/populate.rb'
 require 'facets/kernel/resc.rb'
 require 'facets/kernel/respond.rb'
 require 'facets/kernel/silence.rb'
 require 'facets/kernel/singleton_class.rb'
+require 'facets/kernel/suppress.rb'
 require 'facets/kernel/with.rb'
 

data/lib/facets/kernel/__class__.rb

@@ -0,0 +1,9 @@
+module Kernel
+
+  # Defines core method __class__ as an alias of class.
+  # This allows you to use #class as your own method, without
+  # loosing the ability to determine the object's class.
+
+  alias_method :__class__, :class
+
+end

data/lib/facets/kernel/__get__.rb

@@ -0,0 +1,10 @@
+module Kernel
+
+  # Shadow method for instance_variable_get.
+  alias_method :__get__, :instance_variable_get
+
+  # Shadow method for instance_variable_set.
+  alias_method :__set__, :instance_variable_set
+
+end
+

data/lib/facets/kernel/__set__.rb

@@ -0,0 +1 @@
+require 'facets/kernel/__get__'

data/lib/facets/kernel/instance_assign.rb

@@ -0,0 +1,41 @@
+module Kernel
+
+  # Return instance variable values in an array.
+  #
+  #   class X
+  #     def initialize(a,b)
+  #       @a, @b = a, b
+  #     end
+  #   end
+  #
+  #   x = X.new(1,2)
+  #
+  #   x.instance_values   #=> { "a"=>1, "b"=>2 }
+  #
+  # WARNING: #instance_values will be deprecated. Use instance_vars.to_hash instead.
+
+  def instance_values
+    instance_variables.inject({}) do |values, name|
+      values[name[1..-1]] = instance_variable_get(name)
+      values
+    end
+  end
+
+  # Set instance variables using a hash.
+  #
+  #   instance_assign('@a'=>1, '@b'=>2)
+  #   @a   #=> 1
+  #   @b   #=> 2
+  #
+  # WARNING: #instance_assign will be deprecated. Use instance_vars.update instead.
+
+  def instance_assign(hash)
+    hash.each do |k,v|
+      k = "@#{k}" if k !~ /^@/
+      instance_variable_set(k, v)
+    end
+    return self
+  end
+
+end
+