facets 2.8.4 → 2.9.0.pre.1

data/NOTES

@@ -1,143 +0,0 @@
-= Facets Development Notes
-
-This is a record of some musings along the way in the creatiojn of
-Facets. It is not in any way all that important. Its' simply here
-to give some historical context to development and to provide and
-cues for recollection.
-
-== Testing Rails with Facets Loaded
-
-Add this to Rails' Rakefile:
-
-  task 'test:facets' do
-    require 'activesupport'
-    require 'facets'
-    Rake::Task['test'].invoke
-  end
-
-Run 'rake test:facets'.
-
-== On the Name "Ruby Facets"
-
-A lot of mental anguish went into finding this good project name Ruby Facets. Of course, in the end only one name can take the honor. Other good names which were considered: Calibre, Florida and California, Warchest w/ Atomix, Downs & Ace, Trix & Atomx and even Pillbox & Pills (a _why suggestion). Then the names that almost won out and were used for a good while: Nano Methods and Mega Modules --great names but a little too "fad". Finally let's not forget even older "working" titles that were used along the way: Raspberry, ABC, Succ and the very original Tomslib.
-
-== Features that May Return
-
-[EXTACTED FROM README]
-
-It is possible to eliminate the need for the 'facets/' prefix on requires if the Facets libpaths are added to the LOAD_PATH. But this isn't as straight-forward as it is for most libraries b/c of the layout of Facets library.
-
-  require 'facets-topload'
-  require 'basicobject'
-
-Understand that on the off chance that another library has the same name as one of Facets' everything will still work fine. You will just not be able to use the prefixless shortcut to require it.
-
-== Some convesion extemnsions that turned out to be bad.
-
-  class Symbol
-
-    # Same functionality as before, just a touch more efficient.
-    #
-    #--
-    # CHANGE transami@gmail.com - removed #freeze from #id2name
-    # BAD BAD. Somehow it breaks things. Very weired breaks too,
-    # like making Time#parse alwsy output Time.now _after_ first use.
-    #++
-
-    def to_s
-      @to_s || (@to_s = id2name)
-    end
-
-    # Symbol's really are just simplified strings.
-    # Thus #to_str seems quite reasonable.
-    # This uses the Kernal#String method.
-    #--
-    # Maybe just change to #to_s?
-    # BTW: This would be lots faster, I bet, if implemented in core.
-    #
-    # NOTE This causes Struct.new to bomb!
-    #++
-
-    def to_str
-      String( self )
-    end
-
-  end
-
-== String#to_a extension is too dangerous
-
-  class String
-
-    # Essentially makes #to_a an alias for split,
-    # with the exception that if no divider is given
-    # then the array is split on charaters, and
-    # NOT on the global input record divider ($/).
-    #
-    # WARNING There is a slight chance of
-    # incompatability with other libraries which
-    # depend on spliting with $/ (although doing
-    # so is a very bad idea!).
-
-    #def to_a(div=//,limit=0)
-    #  split(div,limit)
-    #end
-
-  end
-
-== Lazy Enumerator
-
-Brian Candler provided his Filter class.
-
-Originally he had suggested to the Ruby community the idea l-methods for Enumerable.
-Eg. lmap, lselect, etc.
-
-== On <i>instance_</i> 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.
-
-
-== On <i>object_</i> Methods
-
-I was considering this core addition to Facets:
-
-  module Kernel
-    alias_method :object_dup, :dup
-    alias_method :object_clone, :clone
-  end
-
-Already Facets has #object_class. The method goes along with #object_id
-and serves to stay out of the programmers way. Of course, since 'class'
-is a keyword in Ruby, it doesn't help as much. However, mwhen using
-method_missing one can exclude all object_* methods from removal so
-as to still have access to these important introspective methods. That's
-what I have traditionally done. Essentially,
-
-  private *instance_methods.select{ |m| m !~ /^(__|instance_|object__)/ }
-
-With the advent of 1.9 and BasicObject, this is no longer as important,
-but BasicObject leaves us in a bit of a lurch, b/c it removes nearly 
-everything leaving us no recourse to these methods. I can think of two
-good solutions: 1) Have some global "methods" that can handle objects
-at a higher level of abstraction. These can be defined as lambdas and
-called using#[], eg.
-
-  $class[x]
-  $id[x]
-  $dup[x]
-
-The other is to define a special method, perhaps #object, using fluent
-notaiton, we could handle this in a more object-oritented fashion:
-
-  x.object.class
-  x.object.id
-  x.object.dup
-
-In anycase, whatever might come along to provide this functionality, it
-is clear that "object_" methods will not be the solution, and for
-that reason #object_dup and #object_clone will never be facets.
-

data/demo/hook.rdoc

@@ -1,49 +0,0 @@
-= Hook Library
-
-Require the hook.rb library.
-
-  require 'facets/hook'
-
-Build a class with signals.
-
-  class X
-    include Hook
-
-    def course
-      @course ||= []
-    end
-
-    hook :signal
-
-    def boom(event, message)
-      course << "Kaboom!"
-    end
-
-    signal do |event, message|
-      course << ["1", event, message]
-    end
-
-    signal do |event, message|
-      course << ["2", event, message]
-    end
-
-    signal :boom
-
-  end
-
-Triger the signal.
-
-  x = X.new
-  x.signal("hi")
-
-The hooks should have been fired.
-
-  x.course[0].should == ["1", :signal, "hi"]
-  x.course[1].should == ["2", :signal, "hi"]
-  x.course[2].should == "Kaboom!"
-  x.course[3].should == nil
-  
-QED.
-
----
-require 'ae/should'

data/demo/scenario_require.rdoc

@@ -1,7 +0,0 @@
-= Requiring Facets
-
-We should be able to require all the core libraries 
-by simply:
-
-  require 'facets'
-

data/lib/core/facets-live.rb

@@ -1,19 +0,0 @@
-require 'facets/opesc'
-
-class Object
-
-  # This will automatically load (most) core methods
-  # if they are not present when called.
-
-  def method_missing(methodname, *a, &b)
-    methodname = OpEsc.escape(methodname)
-    begin
-      require "facets/#{class}/#{methodname}"
-      __send__(methodname, *a, &b)
-    rescue LoadError
-      super
-    end  
-  end
-
-end
-

data/lib/core/facets-load.rb

@@ -1,12 +0,0 @@
-# This simply adds core/facets to the load path so
-# that you can more easily cherry pick methods,
-# if that's how you prefer to use facets.
-#
-# Ex.
-#
-#   require 'facets-load'
-#   require 'kernel/with'
-#   require 'symbol/to_proc'
-#
-$LOAD_PATH << FILE.dirname(__FILE__) + '/core/facets'
-

data/lib/core/facets/array/recursive.rb

@@ -1,91 +0,0 @@
-require 'facets/enumerable/recursive'
-
-class Array
-
-  # Apply a block to array, and recursively apply that block
-  # to each subarray.
-  #
-  #   arr = ["a", ["b", "c", nil], nil]
-  #   arr.recursively{|a| a.compact! }
-  #   => ["a", ["b", "c"]]
-  #
-  def recursive(opts={}, &block)
-    if block
-      a = inject([]) do |array, value|
-        if value.is_a?(Array)
-          array << value.recursive(&block)
-        else
-          array << value
-        end
-        array
-      end
-      yield a
-    else
-      Recursor.new(self, opts)
-    end
-  end
-
-  # In place form of #recursive.
-
-  def recursive!(&block)
-    r = recursive(&block)
-    raise TypeError unless Array === r
-    replace(r)
-  end
-
- 
-  #
-  class Recursor < ::Enumerable::Recursor
-
-    # Recursively iterate over the Array's elements.
-    # If an element is an Array or responds to #to_ary
-    # then it will be itereated over as well.
-    #
-    def each(&block)
-      if block_given?
-        @enum.each do |e|
-          if Array === e || e.respond_to?(:to_ary)
-            e.to_ary.recursive.each(&block)
-          else
-            block.call(e)
-          end
-        end
-      else
-        to_enum(:each)
-      end
-    end
-
-    # Returns a new array created by traversing the array and its
-    # sub-arrays, executing the given block on the elements.
-    #
-    #   h = ["A", "B", ["X", "Y"]]
-    #
-    #   g = h.recursive.map{ |e| e.downcase }
-    #
-    #   g = ["a", "b", ["x", "y"]]
-    #
-    # CREDIT: Trans
-
-    def map(&block)
-      if block_given?
-        @enum.map do |e|
-          if Array === e || e.respond_to?(:to_ary)
-            e.to_ary.recursive.map(&block)
-          else
-            block.call(e)
-          end
-        end
-      else
-        to_enum(:map)
-      end
-    end
-
-    # Like #map, but will change the array in place.
-
-    def map!(&block)
-      replace(map(&block))
-    end
-
-  end
-
-end

data/lib/core/facets/array/stackable.rb

@@ -1,33 +0,0 @@
-require 'facets/array/splice'
-require 'facets/stackable'
-
-class Array
-
-  include Stackable
-
-  # "Put On Top". This is an alias for unshift
-  # which puts an object# on top of the stack.
-  # It is the converse of push.
-  #
-  #   a=[1,2,3]
-  #   a.poke(9)   #=> [9,1,2,3]
-  #   a           #=> [9,1,2,3]
-  #
-  # CREDIT: Trans
-
-  alias_method :poke, :unshift
-
-  # Alias for shift which removes an object
-  # off first slot of an array. This is
-  # the contrary of pop.
-  #
-  #   a=[1,2,3]
-  #   a.pull  #=> 1
-  #   a       #=> [2,3]
-  #
-  # CREDIT: Trans
-
-  alias_method :pull, :shift
-
-end
-

data/lib/core/facets/blank.rb

@@ -1,60 +0,0 @@
-# = Blank
-#
-# Core extension method #blank? added to core clesses.
-
-#
-module Kernel
-  # An object is blank if it's nil, empty, or a whitespace string.
-  # For example, "", "   ", nil, [], and {} are blank.
-  #
-  # This simplifies
-  #   if !address.nil? && !address.empty?
-  # to
-  #   if !address.blank?
-  def blank?
-    respond_to?(:empty?) ? empty? : !self
-  end
-end
-
-class NilClass
-  def blank?
-    true
-  end
-end
-
-class FalseClass
-  def blank?
-    true
-  end
-end
-
-class TrueClass
-  def blank?
-    false
-  end
-end
-
-class Array
-  alias_method :blank?, :empty?
-end
-
-class Hash
-  alias_method :blank?, :empty?
-end
-
-class String
-  # Is this string just whitespace?
-  #
-  #   "abc".blank?  #=> false
-  #   "   ".blank?  #=> true
-  def blank?
-    self !~ /\S/
-  end
-end
-
-class Numeric
-  def blank?
-    false
-  end
-end
-

data/lib/core/facets/cattr.rb

@@ -1,2 +0,0 @@
-# TO BE DEPRECATED
-require 'facets/class/cattr'

data/lib/core/facets/class/cattr.rb

@@ -1,112 +0,0 @@
-class Class
-
-  # Creates a class-variable attribute that can
-  # be accessed both on an instance and class level.
-  #
-  # NOTE This used to be a Module method. But turns out
-  # it does not work as expected when included. The class-level
-  # method is not carried along. So it is now just a Class
-  # method. Accordingly, #mattr has been deprecated.
-  #
-  # CREDIT: David Heinemeier Hansson
-  def cattr( *syms )
-    writers, readers = syms.flatten.partition{ |a| a.to_s =~ /=$/ }
-    writers = writers.collect{ |e| e.to_s.chomp('=').to_sym }
-    readers.concat( writers ) # writers also get readers
-    cattr_writer( *writers )
-    cattr_reader( *readers )
-    return readers + writers
-  end
-
-  # Creates a class-variable attr_reader that can
-  # be accessed both on an instance and class level.
-  #
-  #   class MyClass
-  #     @@a = 10
-  #     cattr_reader :a
-  #   end
-  #
-  #   MyClass.a           #=> 10
-  #   MyClass.new.a       #=> 10
-  #
-  # CREDIT: David Heinemeier Hansson
-  def cattr_reader( *syms )
-    syms.flatten.each do |sym|
-      class_eval(<<-EOS, __FILE__, __LINE__)
-        unless defined? @@#{sym}
-          @@#{sym} = nil
-        end
-
-        def self.#{sym}
-          @@#{sym}
-        end
-
-        def #{sym}
-          @@#{sym}
-        end
-      EOS
-    end
-    return syms
-  end
-
-  # Creates a class-variable attr_writer that can
-  # be accessed both on an instance and class level.
-  #
-  #   class MyClass
-  #     cattr_writer :a
-  #     def a
-  #       @@a
-  #     end
-  #   end
-  #
-  #   MyClass.a = 10
-  #   MyClass.a            #=> 10
-  #   MyClass.new.a = 29
-  #   MyClass.a            #=> 29
-  #
-  # CREDIT: David Heinemeier Hansson
-  def cattr_writer(*syms)
-    syms.flatten.each do |sym|
-      class_eval(<<-EOS, __FILE__, __LINE__)
-        unless defined? @@#{sym}
-          @@#{sym} = nil
-        end
-
-        def self.#{sym}=(obj)
-          @@#{sym} = obj
-        end
-
-        def #{sym}=(obj)
-          @@#{sym}=(obj)
-        end
-      EOS
-    end
-    return syms
-  end
-
-  # Creates a class-variable attr_accessor that can
-  # be accessed both on an instance and class level.
-  #
-  #   class MyClass
-  #     cattr_accessor :a
-  #   end
-  #
-  #   MyClass.a = 10
-  #   MyClass.a           #=> 10
-  #   mc = MyClass.new
-  #   mc.a                #=> 10
-  #
-  # CREDIT: David Heinemeier Hansson
-  def cattr_accessor(*syms)
-    cattr_reader(*syms) + cattr_writer(*syms)
-  end
-
-end
-
-# Not properly applicable to modules, so these have been deprecated.
-#class Module
-  #alias_method :mattr,          :cattr            # deprecate
-  #alias_method :mattr_reader,   :cattr_reader     # deprecate
-  #alias_method :mattr_writer,   :cattr_writer     # deprecate
-  #alias_method :mattr_accessor, :cattr_accessor   # deprecate
-#end