facets 2.9.2 → 2.9.3

data/work/NOTES.rdoc

@@ -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/work/bench/bench_load.rb

@@ -1,56 +0,0 @@
-require 'benchmark'
-
-# Load check all libs.
-
-def test_load
-
-  while !File.directory?('lib/core/facets') do
-    Dir.chdir('..')
-  end
-
-  abort "Can't find project root." unless File.directory?('lib/core/facets')
-
-  @scripts = {}
-
-  Dir.chdir('lib/core') do
-    @scripts[:core] = Dir.glob('facets/*.rb')
-    @scripts[:core].uniq!
-  end
-
-  Dir.chdir('lib/lore') do
-    @scripts[:lore] = Dir.glob('facets/*.rb')
-    @scripts[:lore].uniq!
-  end
-
-  Dir.chdir('lib/more') do
-    @scripts[:more] = Dir.glob('facets/*.rb')
-    @scripts[:more].uniq!
-  end
-
-  $:.unshift('lib/core')
-  $:.unshift('lib/lore')
-  $:.unshift('lib/more')
-
-  $VERBOSE = nil
-
-  Benchmark.bm do |x|
-    x.report("core"){ require_scripts(:core) }
-    x.report("lore"){ require_scripts(:lore) }
-    x.report("more"){ require_scripts(:more) }
-  end
-end
-
-def require_scripts(key)
-  @scripts[key].each do |file|
-    begin
-      require file
-    rescue Exception => e
-      puts file
-      puts e.message
-    end
-  end
-end
-
-if $0 == __FILE__
-  test_load
-end

data/work/bench/enumerable/bench_collect.rb

@@ -1,84 +0,0 @@
-require 'benchmark'
-
-module Enumerable
-
-  # group_by
-
-  def group_by_1(&block)
-    h = k = e = nil
-    r = Hash.new
-    each{|e| (r[yield(e)] ||= []) << e}
-    r
-  end
-
-  def group_by_2(&block)
-    r = Hash.new{ |h,k| h[k]=[] }
-    each{|e| r[yield(e)] << e}
-    r
-  end
-
-  # cluster_by
-
-  def cluster_by_1(&block)
-    group_by_1(&block).values  # No sorting.
-  end
-
-  def cluster_by_2(&block)
-    #partition_by_fast(&block).values.sort    # Sorted by value.
-    group_by_1(&block).sort.transpose.pop  # Sorted by key.
-  end
-
-  def cluster_by_3(&block)        # As defined by Facets.
-    h = {}
-    each{|e| (h[block[e]] ||= []) << e}
-    h.keys.sort!.map{|k| h[k]}        # Sorted by key.
-  end
-
-end
-
-#
-
-Benchmark.bmbm do |x|
-  n = 10
-  a = (0...10000).to_a + (0...10000).to_a
-  h = (0...10000).inject({}){|h, e| h[e] = e ; h}
-
-  # group_by
-
-  x.report("group_by_1") do
-    n.times do
-      a.group_by_1{|e| e % 10}
-      h.group_by_1{|k, v| v % 10}
-    end
-  end
-
-  x.report("group_by_2") do
-    n.times do
-      a.group_by_2{|e| e % 10}
-      h.group_by_2{|k, v| v % 10}
-    end
-  end
-
-  # cluster_by
-
-  x.report("cluster_by_1") do
-    n.times do
-      a.cluster_by_1{|e| e % 10}
-      h.cluster_by_1{|k, v| v % 10}
-    end
-  end
-
-  x.report("cluster_by_2") do
-    n.times do
-      a.cluster_by_2{|e| e % 10}
-      h.cluster_by_2{|k, v| v % 10}
-    end
-  end
-
-  x.report("cluster_by_3") do
-    n.times do
-      a.cluster_by_3{|e| e % 10}
-      h.cluster_by_3{|k, v| v % 10}
-    end
-  end
-end

data/work/bench/enumerable/bench_count.rb

@@ -1,58 +0,0 @@
-require 'benchmark'
-
-module Enumerable
-
-  # duplicates
-
-  def duplicates_1
-    h1 = {}
-    h2 = {}
-    each {|i|
-      h2[i] = true if h1[i]
-      h1[i] = true
-    }
-    h2.keys
-  end
-
-  def duplicates_2
-    inject(Hash.new(0)){|h,v| h[v]+=1; h}.reject{|k,v| v==1}.keys
-  end
-
-  # uniq_by
-
-  def uniq_by_1 #:yield:
-    h = {}; inject([]) {|a,x| h[yield(x)] ||= a << x}
-  end
-
-  def uniq_by_2
-    inject({}) { |h,x| h[yield(x)] ||= x; h }.values
-  end
-
-end
-
-#
-
-Benchmark.bmbm do |x|
-  n = 10000
-  a = [1,1,2,3,4,4,5,6,7,7]
-
-  # duplicates
-
-  x.report("duplicates_1") do
-    n.times { a.duplicates_1 }
-  end
-
-  x.report("duplicates_2") do
-    n.times { a.duplicates_2 }
-  end
-
-  # uniq_by
-
-  x.report("uniq_by_1") do
-    n.times { a.uniq_by_1{ |x| x } }
-  end
-
-  x.report("uniq_by_2") do
-    n.times { a.uniq_by_2{ |x| x } }
-  end
-end

data/work/bench/general/bench_calls.rb

@@ -1,74 +0,0 @@
-=begin
-
-Some speed comparisions between ways to call a method.
-
-=end
-
-require 'benchmark'
-
-$n = 50000
-
-# standard array
-
-def callme ; 1 ; end
-
-$m = self.class.instance_method(:callme)
-
-
-def call_normal
-  $n.times do
-    callme
-  end
-end
-
-def call_by_send_symbol
-  $n.times do
-    send(:callme)
-  end
-end
-
-def call_by_send_string
-  $n.times do
-    send("callme")
-  end
-end
-
-def call_by_eval
-  $n.times do
-    eval "callme"
-  end
-end
-
-def call_by_instance_eval
-  $n.times do
-    instance_eval { callme }
-  end
-end
-
-def call_by_bind
-  $n.times do
-    $m.bind(self).call
-  end
-end
-
-def call_inst_eval_send
-  $n.times do
-    $m.instance_eval { send(:callme) }
-  end
-end
-
-### --- bench ---
-
-puts "\nCURRENT"
-Benchmark.bm(15) do |b|
-  b.report("normal          :") { call_normal }
-  b.report("send_symbol     :") { call_by_send_symbol }
-  b.report("send_string     :") { call_by_send_string }
-  b.report("bind            :") { call_by_bind }
-  b.report("instance_eval   :") { call_by_instance_eval }
-  b.report("by_eval         :") { call_by_eval }
-  b.report("inst_eval_send  :") { call_inst_eval_send }
-end
-
-
-

data/work/bench/general/bench_includes.rb

@@ -1,25 +0,0 @@
-
-$n = 100
-
-puts "Generating #{$n} cascading modules..."
-
-$m = []
-(1..$n).each { |i|
-  $m[i] = Module.new
-  $m[i].class_eval {
-    define_method( "_#{i}" ) { puts "Called method in module #{i}." }
-    include $m[i-1] if $m[i-1]
-  }
-}
-
-class ManyIncludes
-  include $m[$n]
-end
-
-mm = ManyIncludes.new
-mn = "_#{$n/2}"
-
-t0 = Time.now
-mm.send(mn)
-t1 = Time.now
-puts "Time to call a single method among #{$n} modules: #{(t1 - t0).to_f} seconds."

data/work/bench/general/bench_methods.rb

@@ -1,17 +0,0 @@
-
-class ManyMethods
-
-  puts "Generating methods..."
-
-  (0..100000).each do |i|
-    define_method( "_#{i}" ) { puts "Called method #{i}." }
-  end
-
-end
-
-mm = ManyMethods.new
-
-n1 = Time.now
-mm._50000
-n2 = Time.now
-puts "Time to call a single method among 100000: #{(n2 - n1).to_f} seconds."