facets 2.4.2 → 2.4.3

data/doc/ri/CLI/cdesc-CLI.yaml

@@ -4,8 +4,13 @@ attributes: []
 class_methods: []
 
 comment: 
-constants: []
-
+constants: 
+- !ruby/object:RI::Constant 
+  comment: 
+  - !ruby/struct:SM::Flow::P 
+    body: Temporary backward compatability.
+  name: MasterCommand
+  value: Command
 full_name: CLI
 includes: []
 

data/doc/ri/Enumerable/probability-i.yaml

@@ -4,7 +4,7 @@ aliases: []
 block_params: 
 comment: 
 - !ruby/struct:SM::Flow::P 
-  body: Generates a hash mapping each unique symbol in the array to the relative frequency, i.e. the probablity, of it appearence.
+  body: Generates a hash mapping each unique element in the array to the relative frequency, i.e. the probablity, of it appearence.
 - !ruby/struct:SM::Flow::VERB 
   body: "  CREDIT: Brian Schr\xC3\xB6der\n"
 full_name: Enumerable#probability

data/doc/ri/Module/append_features-i.yaml

@@ -1,10 +1,11 @@
 --- !ruby/object:RI::MethodDescription 
-aliases: []
-
+aliases: 
+- !ruby/object:RI::AliasName 
+  name: append_features_without_class_extension
 block_params: 
 comment: 
 full_name: Module#append_features
 is_singleton: false
 name: append_features
-params: (mod)
+params: ( base )
 visibility: public

data/doc/ri/Module/cdesc-Module.yaml

@@ -9,9 +9,8 @@ comment: []
 constants: []
 
 full_name: Module
-includes: 
-- !ruby/object:RI::IncludedModule 
-  name: CloneExtensions
+includes: []
+
 instance_methods: 
 - !ruby/object:RI::MethodSummary 
   name: "*"
@@ -135,6 +134,8 @@ instance_methods:
   name: method_overloads
 - !ruby/object:RI::MethodSummary 
   name: method_space
+- !ruby/object:RI::MethodSummary 
+  name: methodize
 - !ruby/object:RI::MethodSummary 
   name: mixin_parameters
 - !ruby/object:RI::MethodSummary 

data/doc/ri/Module/methodize-i.yaml

@@ -0,0 +1,14 @@
+--- !ruby/object:RI::MethodDescription 
+aliases: []
+
+block_params: 
+comment: 
+- !ruby/struct:SM::Flow::P 
+  body: Translate a module name to a suitable method name.
+- !ruby/struct:SM::Flow::VERB 
+  body: "  My::CoolClass.methodize => "my__cool_class"\n"
+full_name: Module#methodize
+is_singleton: false
+name: methodize
+params: ()
+visibility: public

data/doc/ri/Module/redefine_method-i.yaml

@@ -9,7 +9,7 @@ comment:
 - !ruby/struct:SM::Flow::P 
   body: If <em>aka</em> is given, then the method being redefined will first be aliased to this name.
 - !ruby/struct:SM::Flow::VERB 
-  body: "  class Greeter\n    def hello ; &quot;Hello&quot; ; end\n  end\n\n  Greeter.new.hello   #=&gt; &quot;Hello&quot;\n\n  class Greeter\n    redefine_method( :hello, :hi ) do\n      hi + &quot;, friend!&quot;\n    end\n  end\n\n  Greeter.new.hello   #=&gt; &quot;Hello, friend!&quot;\n\n  CREDIT: Trans\n"
+  body: "  class Greeter\n    def hello ; &quot;Hello&quot; ; end\n  end\n\n  Greeter.new.hello   #=&gt; &quot;Hello&quot;\n\n  class Greeter\n    redefine_method( :hello, :hi ) do\n      hi + &quot;, friend!&quot;\n    end\n  end\n\n  Greeter.new.hello   #=&gt; &quot;Hello, friend!&quot;\n\n CREDIT: Trans\n"
 full_name: Module#redefine_method
 is_singleton: false
 name: redefine_method

data/doc/ri/Module/redirect_method-i.yaml

@@ -11,7 +11,9 @@ comment:
 - !ruby/struct:SM::Flow::P 
   body: "The above class definition is equivalent to:"
 - !ruby/struct:SM::Flow::VERB 
-  body: "  class Example\n    def hi(*args)\n      hello(*args)\n    end\n    def hey(*args)\n      hello(*args)\n    end\n    def hello\n      puts "Hello"\n    end\n  end\n\n  CREDIT: Trans\n"
+  body: "  class Example\n    def hi(*args)\n      hello(*args)\n    end\n    def hey(*args)\n      hello(*args)\n    end\n    def hello\n      puts "Hello"\n    end\n  end\n"
+- !ruby/struct:SM::Flow::P 
+  body: "CREDIT: Trans"
 full_name: Module#redirect_method
 is_singleton: false
 name: redirect_method

data/doc/ri/Module/rename_method-i.yaml

@@ -7,7 +7,7 @@ comment:
 - !ruby/struct:SM::Flow::P 
   body: Aliases a method and undefines the original.
 - !ruby/struct:SM::Flow::VERB 
-  body: "  rename_method( :to_method, :from_method  )\n\n  CREDIT: Trans\n"
+  body: "  rename_method( :to_method, :from_method  )\n\n CREDIT: Trans\n"
 full_name: Module#rename_method
 is_singleton: false
 name: rename_method

data/doc/ri/created.rid

@@ -1 +1 @@
-Tue, 12 Aug 2008 23:36:17 -0400
+Wed, 13 Aug 2008 19:26:46 -0400

data/lib/core/facets/array.rb

@@ -10,14 +10,17 @@
 require 'facets/array/combination.rb'
 require 'facets/array/conjoin.rb'
 require 'facets/array/delete.rb'
+require 'facets/array/indexable.rb'
 require 'facets/array/merge.rb'
 require 'facets/array/not_empty'
 require 'facets/array/only'
 require 'facets/array/pad.rb'
 require 'facets/array/permutation.rb'
 require 'facets/array/product.rb'
+require 'facets/array/recursively.rb'
 require 'facets/array/rotate.rb'
 require 'facets/array/select.rb'
 require 'facets/array/splice.rb'
+require 'facets/array/stackable.rb'
 require 'facets/array/traverse.rb'
 

data/lib/core/facets/binding.rb

@@ -3,6 +3,5 @@ require 'facets/binding/eval'
 require 'facets/binding/caller'
 require 'facets/binding/defined'
 require 'facets/binding/local_variables'
-#require 'facets/binding/opvars'
 require 'facets/binding/self'
 

data/lib/core/facets/class.rb

@@ -1,7 +1,7 @@
 require 'facets/class/descendents'
-#require 'facets/class/prepend'
-#require 'facets/class/subclasses'
-#require 'facets/class/to_methodname'
-#require 'facets/class/to_pathname'
+require 'facets/class/prepend'
+require 'facets/class/subclasses'
+require 'facets/class/methodize'
+require 'facets/class/pathize'
 require 'facets/class/to_proc'
 

data/lib/core/facets/class/{to_methodname.rb → methodize.rb}

@@ -1,11 +1,14 @@
+require 'facets/string/methodize'
+
 class Class
 
   # Translate a class name to a suitable method name.
   #
   #   My::CoolClass.methodize => "my__cool_class"
   #
-  def to_methodname
-    name.gsub(/([A-Z]+)([A-Z])/,'\1_\2').gsub(/([a-z])([A-Z])/,'\1_\2').gsub('::','__').downcase
+  def methodize
+    name.methodize
   end
 
 end
+

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

@@ -0,0 +1,14 @@
+require 'facets/string/pathize'
+
+class Class
+
+  # Converts a class name to a unix path.
+  #
+  #   My::CoolClass.pathize  #=> "my/cool_class"
+  #
+  def pathize
+    name.pathize
+  end
+
+end
+

data/lib/core/facets/enumerable.rb

@@ -1,20 +1,23 @@
 require 'facets/enumerable/accumulate.rb'
 require 'facets/enumerable/cluster_by.rb'
 require 'facets/enumerable/collect.rb'
+require 'facets/enumerable/commonality.rb'
 require 'facets/enumerable/count.rb'
 require 'facets/enumerable/divide.rb'
 require 'facets/enumerable/duplicates.rb'
 require 'facets/enumerable/each_by.rb'
+require 'facets/enumerable/entropy.rb'
+require 'facets/enumerable/frequency.rb'
 require 'facets/enumerable/group_by.rb'
 require 'facets/enumerable/inject.rb'
-require 'facets/enumerable/mash.rb'
 require 'facets/enumerable/map_send.rb'
+require 'facets/enumerable/mash.rb'
 require 'facets/enumerable/mode.rb'
 require 'facets/enumerable/modulate.rb'
+require 'facets/enumerable/probability.rb'
 require 'facets/enumerable/none.rb'
 require 'facets/enumerable/occur.rb'
 require 'facets/enumerable/one.rb'
-#require 'facets/enumerable/probablity.rb'
 require 'facets/enumerable/split.rb'
 require 'facets/enumerable/sum.rb'
 require 'facets/enumerable/uniq_by.rb'

data/lib/core/facets/enumerable/commonality.rb

@@ -0,0 +1,33 @@
+module Enumerable
+
+  # Returns all items that are equal in terms of the supplied block.
+  # If no block is given objects are considered to be equal if they
+  # return the same value for Object#hash and if obj1 == obj2.
+  #
+  #   [1, 2, 2, 3, 4, 4].commonality # => { 2 => [2], 4 => [4] }
+  #
+  #   ["foo", "bar", "a"].commonality { |str| str.length }
+  #   # => { 3 => ["foo, "bar"] }
+  #
+  #   # Returns all persons that share their last name with another person.
+  #   persons.collisions { |person| person.last_name }
+  #
+  #   CREDIT: Florian Gross
+
+  def commonality( &block )
+    had_no_block = !block
+    block ||= lambda { |item| item }
+    result = Hash.new { |hash, key| hash[key] = Array.new }
+    self.each do |item|
+      key = block.call(item)
+      result[key] << item
+    end
+    result.reject! do |key, values|
+      values.size <= 1
+    end
+    #return had_no_block ? result.values.flatten : result
+    return result
+  end
+
+end
+

data/lib/core/facets/enumerable/entropy.rb

@@ -0,0 +1,37 @@
+require 'facets/enumerable/probability'
+
+module Enumerable
+
+  # Shannon's entropy for an array - returns the average
+  # bits per symbol required to encode the array.
+  # Lower values mean less "entropy" - i.e. less unique
+  # information in the array.
+  #
+  #   %w{ a b c d e e e }.entropy  #=>
+  #
+  #   CREDIT: Derek
+
+  def entropy
+    arr = to_a
+    probHash = arr.probability
+    # h is the Shannon entropy of the array
+    h = -1.to_f * probHash.keys.inject(0.to_f) do |sum, i|
+      sum + (probHash[i] * (Math.log(probHash[i])/Math.log(2.to_f)))
+    end
+    h
+  end
+
+  # Returns the maximum possible Shannon entropy of the array
+  # with given size assuming that it is an "order-0" source
+  # (each element is selected independently of the next).
+  #
+  #   CREDIT: Derek
+
+  def ideal_entropy
+    arr = to_a
+    unitProb = 1.0.to_f / arr.size.to_f
+    (-1.to_f * arr.size.to_f * unitProb * Math.log(unitProb)/Math.log(2.to_f))
+  end
+
+end
+

data/lib/core/facets/enumerable/frequency.rb

@@ -0,0 +1,18 @@
+module Enumerable
+
+  # Generates a hash mapping each unique symbol in the array
+  # to the absolute frequency it appears.
+  #
+  #  CREDIT: Brian Schröder
+
+  def frequency
+    #probs = Hash.new(0)
+    #each do |e|
+    #  probs[e] += 1
+    #end
+    #probs
+    inject(Hash.new(0)){|h,v| h[v]+=1; h}
+  end
+
+end
+

data/lib/core/facets/enumerable/probability.rb

@@ -1,6 +1,6 @@
 module Enumerable
 
-  # Generates a hash mapping each unique symbol in the array
+  # Generates a hash mapping each unique element in the array
   # to the relative frequency, i.e. the probablity, of
   # it appearence.
   #
@@ -32,102 +32,5 @@ module Enumerable
   #     probHash
   #   end
 
-  # Shannon's entropy for an array - returns the average
-  # bits per symbol required to encode the array.
-  # Lower values mean less "entropy" - i.e. less unique
-  # information in the array.
-  #
-  #   %w{ a b c d e e e }.entropy  #=>
-  #
-  #   CREDIT: Derek
-
-  def entropy
-    arr = to_a
-    probHash = arr.probability
-    # h is the Shannon entropy of the array
-    h = -1.to_f * probHash.keys.inject(0.to_f) do |sum, i|
-      sum + (probHash[i] * (Math.log(probHash[i])/Math.log(2.to_f)))
-    end
-    h
-  end
-
-  # Returns the maximum possible Shannon entropy of the array
-  # with given size assuming that it is an "order-0" source
-  # (each element is selected independently of the next).
-  #
-  #   CREDIT: Derek
-
-  def ideal_entropy
-    arr = to_a
-    unitProb = 1.0.to_f / arr.size.to_f
-    (-1.to_f * arr.size.to_f * unitProb * Math.log(unitProb)/Math.log(2.to_f))
-  end
-
-  # Generates a hash mapping each unique symbol in the array
-  # to the absolute frequency it appears.
-  #
-  #  CREDIT: Brian Schröder
-
-  def frequency
-    #probs = Hash.new(0)
-    #each do |e|
-    #  probs[e] += 1
-    #end
-    #probs
-    inject(Hash.new(0)){|h,v| h[v]+=1; h}
-  end
-
-  # Returns all items that are equal in terms of the supplied block.
-  # If no block is given objects are considered to be equal if they
-  # return the same value for Object#hash and if obj1 == obj2.
-  #
-  #   [1, 2, 2, 3, 4, 4].commonality # => { 2 => [2], 4 => [4] }
-  #
-  #   ["foo", "bar", "a"].commonality { |str| str.length }
-  #   # => { 3 => ["foo, "bar"] }
-  #
-  #   # Returns all persons that share their last name with another person.
-  #   persons.collisions { |person| person.last_name }
-  #
-  #   CREDIT: Florian Gross
-
-  def commonality( &block )
-    had_no_block = !block
-    block ||= lambda { |item| item }
-    result = Hash.new { |hash, key| hash[key] = Array.new }
-    self.each do |item|
-      key = block.call(item)
-      result[key] << item
-    end
-    result.reject! do |key, values|
-      values.size <= 1
-    end
-    #return had_no_block ? result.values.flatten : result
-    return result
-  end
-
-  # Like commonality but returns an array of duplicates.
-
-  #def collisions(&blk) #:yield:
-  #  a = []
-  #  commonality(&blk).each{ |k,v| a.concat(v) }
-  #  a.uniq
-  #end
-
 end
 
-
-# class String
-#
-#   NOTE: String#entropy has been deprecated.
-#   Use str.chars.entropy instead.
-#   def entropy
-#     split(//).entropy
-#   end
-#
-#   # Not needed b/c ideal_entropy is only dependent on size.
-#   # def ideal_entropy
-#   #   self.split(//).ideal_entropy
-#   # end
-#
-# end

data/lib/core/facets/file.rb

@@ -1,6 +1,6 @@
 require 'facets/file/null.rb'
 require 'facets/file/read.rb'
-#require 'facets/file/rewrite.rb'
+require 'facets/file/rewrite.rb'
 require 'facets/file/rootname.rb'
 require 'facets/file/write.rb'
 

data/lib/core/facets/hash.rb

@@ -1,3 +1,4 @@
+require 'facets/hash/alias.rb'
 require 'facets/hash/argumentize.rb'
 require 'facets/hash/at.rb'
 require 'facets/hash/autonew.rb'
@@ -12,12 +13,17 @@ require 'facets/hash/keys.rb'
 require 'facets/hash/mash.rb'
 require 'facets/hash/merge.rb'
 require 'facets/hash/op.rb'
+require 'facets/hash/recursive_merge.rb'
+require 'facets/hash/recursively.rb'
 require 'facets/hash/rekey.rb'
 require 'facets/hash/select.rb'
 require 'facets/hash/slice.rb'
+require 'facets/hash/swap.rb'
+require 'facets/hash/to_h.rb'
 require 'facets/hash/to_proc.rb'
 require 'facets/hash/to_struct.rb'
 require 'facets/hash/traverse.rb'
 require 'facets/hash/update.rb'
+require 'facets/hash/weave.rb'
 require 'facets/hash/zipnew.rb'