facets 2.9.0 → 2.9.1

data/HISTORY.rdoc

@@ -1,5 +1,39 @@
 = Facets Release History
 
+== 2.9.1 / 2011-01-30
+
+Primary this release fixes a couple of small issues. In addition a handful of
+additonal methods have been added.
+
+Changes:
+
+* New Features:
+
+  * Add FileTest#absolute? and #relative?
+  * Add FileTest#contains?
+  * Add FileTest#safe?
+  * Add FileUtils#amass
+  * Add FileUtils#outofdate
+  * Add FileUtils#stage
+  * Add Kernel#yes? and Kernel#no?
+  * Add Enumerable#has? (TOUR library)
+  * Add Digest#salted_digest, etc.
+  * Add Digest#base64digest (1.9.2 method)
+  * Add String#random_binary
+
+* Improved Features
+
+  * Better OS detection in Platform class and RBConfig module
+  * Moved CPU byte order methods from RBConfig to Platform class
+  * General improvements to Platform class API
+
+* Bug Fixes
+
+  * Module#redefine_method need not check pre-existence of method
+  * Fix string/unquote.rb recursive require
+  * Kernel#object_hexid varies on CPU arch, bot Ruby version.
+
+
 == 2.9.0 / 2010-09-01
 
 This release is fairly extensive as it was originally intended to be v3.0.

data/{meta/profile → PROFILE}

@@ -15,10 +15,24 @@ description:
   control of requirements. In addition, Facets includes a few additional
   classes and mixins suitable to wide variety of applications.
 
+requires:
+  - syckle (build)
+  - lemon  (test)
+  - qed    (test)
+
 resources:
   home: http://rubyworks.github.com/facets
   code: http://github.com/rubyworks/facets
   docs: http://rubyworks.github.com/facets/learn.html
   wiki: http://wiki.github.com/rubyworks/facets
   talk: http://groups.google.com/group/facets-universal
-  repo: git@github.com:rubyworks/facets.git
+
+repositories:
+  public: git@github.com:rubyworks/facets.git
+
+loadpath:
+  - lib/core
+  - lib/core-uncommon
+  - lib/standard
+  - lib/supplemental
+

data/README.rdoc

@@ -1,9 +1,5 @@
 = Ruby Facets
 
-* home: http://rubyworks.github.com/facets
-* code: http://github.com/rubyworks/facets
-* talk: http://groups.google.com/group/facets-universal
-
 "ALL YOUR BASE ARE BELONG TO RUBY"
 
 
@@ -83,20 +79,18 @@ At the heart of Ruby Facets is the CORE extensions library. CORE provides
 a sizable collection of generally useful methods, along with a few supporting
 classes, that extend the functionality of Ruby's core classes and modules.
 
-By definition CORE contains anything that will load automatically when
-issuing:
-
-  require 'facets'
-
-If you plan to use more then a few of Facets core method it is recommended that
-you require the main facility.
+With the exception of a few *uncommon* extensions, CORE contains anything that
+will load automatically when issuing:
 
   require 'facets'
 
-This loads all the CORE functionality at once.
+This loads all the CORE functionality at once. If you plan to use more then a
+handful of Facets core methods it is recommended that you require the library in
+this way.
 
-Of course you can use the CORE library piecemeal if you prefer. The general
-require statement for a core extensions library is:
+Of course you can use the CORE library piecemeal if you prefer. And for uncommon
+extension this must be done. The general require statement for a core extensions
+library is:
 
   require 'facets/<class|module>/<method-lib>'
 
@@ -163,9 +157,9 @@ file systems. Also, if a method ends in '=', '?' or '!' it is simply removed.
 
 === MORE Library
 
-On top of the extensive Core library, Facet provides a small collection
-of additional modules and classes, as well as extended versions of
-modules and classes in Ruby's Standard library.
+On top of the extensive CORE library, Facets provides extensions for Ruby's
+standard library, as well as very small collection of additional modules and
+classes to supplement it.
 
 Use the More library like you would any other 3rd party library.
 The only difference between Facets More library and other libraries

data/Rakefile

@@ -2,6 +2,8 @@
 
 require 'fileutils'
 
+PATH = "lib/core:lib/core-uncommon:lib/standard:lib/supplemental"
+
 #
 # GENERATE RDOCS
 # ----------------------------------------------------------------------------
@@ -15,8 +17,9 @@ task "rdoc" do
   FileUtils.rm_r(APIOUT)
 
   system "rdoc -a -S -t'Facets Core API' -T #{TEMPLATE} -m README.rdoc --op '#{APIOUT}/core' README.rdoc lib/facets/core"
-  system "rdoc -a -S -t'Facets More API' -T #{TEMPLATE} -m README.rdoc --op '#{APIOUT}/more' README.rdoc lib/facets/more"
-  system "rdoc -a -S -t'Facets Tour API' -T #{TEMPLATE} -m README.rdoc --op '#{APIOUT}/tour' README.rdoc lib/facets/tour"
+  system "rdoc -a -S -t'Facets More API' -T #{TEMPLATE} -m README.rdoc --op '#{APIOUT}/core-uncommon' README.rdoc lib/facets/core-uncommon"
+  system "rdoc -a -S -t'Facets Standard API' -T #{TEMPLATE} -m README.rdoc --op '#{APIOUT}/standard' README.rdoc lib/facets/standard"
+  system "rdoc -a -S -t'Facets Supplemental API' -T #{TEMPLATE} -m README.rdoc --op '#{APIOUT}/supplemental' README.rdoc lib/facets/supplemental"
 end
 
 #
@@ -24,35 +27,40 @@ end
 # ----------------------------------------------------------------------------
 
 task "default" do
-  sh "lemon #{lemon_flags} -Ilib/core:lib/more:lib/tour test/core test/more test/tour"
+  sh "lemon #{lemon_flags} -Ilib/core:lib/core-uncommon:lib/standard:lib/supplemental test/core test/core-uncommon test/standard test/supplemental"
 end
 
 task "test" do
   if tests = ENV['TESTS']
-    sh "lemon #{lemon_flags} -Ilib/core:lib/more:lib/tour #{tests}"
+    sh "lemon #{lemon_flags} -I#{PATH} #{tests}"
   else
-    sh "lemon #{lemon_flags} -Ilib/core:lib/more:lib/tour test/core test/more test/tour"
+    sh "lemon #{lemon_flags} -I#{PATH} test/core test/core-uncommon test/standard test/supplemental"
   end
 end
 
 desc "run all unit tests"
 task "test:all" do
-  sh "lemon #{lemon_flags} -Ilib/core:lib/more:lib/tour test/core test/more test/tour"
+  sh "lemon #{lemon_flags} -I#{PATH} test/core test/core-uncommon test/standard test/supplemental"
 end
 
 desc "run core unit tests"
 task "test:core" do
-  sh "lemon#{lemon_flags}  -Ilib/core test/core"
+  sh "lemon#{lemon_flags} -I#{PATH} test/core"
+end
+
+desc "run uncommon unit tests"
+task "test:uncommon" do
+  sh "lemon #{lemon_flags} -I#{PATH} test/core-uncommon"
 end
 
-desc "run more unit tests"
-task "test:more" do
-  sh "lemon #{lemon_flags} -Ilib/core:lib/more test/more"
+desc "run standard unit tests"
+task "test:standard" do
+  sh "lemon #{lemon_flags} -I#{PATH} test/standard"
 end
 
-desc "run tour unit tests"
-task "test:tour" do
-  sh "lemon #{lemon_flags} -Ilib/core:lib/tour test/tour"
+desc "run supplemental unit tests"
+task "test:supplemental" do
+  sh "lemon #{lemon_flags} -I#{PATH} test/supplemental"
 end
 
 desc "run all unit tests with ActiveSupport loaded"
@@ -61,11 +69,14 @@ task 'test:all:activesupport' => [:include_activesupport, 'test:all']
 desc "run core unit tests with ActiveSupport loaded"
 task 'test:core:activesupport' => [:include_activesupport, 'test:core']
 
-desc "run more unit tests with ActiveSupport loaded"
-task 'test:more:activesupport' => [:include_activesupport, 'test:more']
+desc "run uncommon unit tests with ActiveSupport loaded"
+task 'test:uncommon:activesupport' => [:include_activesupport, 'test:uncommon']
 
-desc "run tour unit tests with ActiveSupport loaded"
-task 'test:more:activesupport' => [:include_activesupport, 'test:tour']
+desc "run standard unit tests with ActiveSupport loaded"
+task 'test:standard:activesupport' => [:include_activesupport, 'test:standard']
+
+desc "run supplemental unit tests with ActiveSupport loaded"
+task 'test:supplemental:activesupport' => [:include_activesupport, 'test:supplemental']
 
 task 'include_activesupport' do
   require 'activesupport'
@@ -84,7 +95,7 @@ end
 #
 #  unless live
 #    # $LOAD_PATH.unshift(File.expand_path('lib/core'))
-#    # $LOAD_PATH.unshift(File.expand_path('lib/more'))
+#    # $LOAD_PATH.unshift(File.expand_path('lib/core-uncommon'))
 #    paths.each do |path|
 #      $LOAD_PATH.unshift(File.expand_path(path))
 #    end
@@ -113,7 +124,7 @@ end
 #end
 
 #def prepare_tests_all
-#  add_loadpath('lib/core','lib/more', 'lib/tour')
+#  add_loadpath('lib/core','lib/core-uncommon', 'lib/tour')
 #  files = get_tests
 #  run_tests(files)
 #end
@@ -129,7 +140,7 @@ end
 #
 #  unless live
 #    $LOAD_PATH.unshift(File.expand_path('lib/core'))
-#    $LOAD_PATH.unshift(File.expand_path('lib/more'))
+#    $LOAD_PATH.unshift(File.expand_path('lib/core-uncommon'))
 #  end
 #
 #  puts "RUBY VERSION: #{RUBY_VERSION}"
@@ -163,7 +174,7 @@ end
 
 desc "show test coverage"
 task "cov" do
-  sh "lemon -Ilib/core:lib/more:lib/tour -c test/core test/more test/tour"
+  sh "lemon -Ilib/core:lib/core-uncommon:lib/tour -c test/core test/core-uncommon test/tour"
 end
 
 desc "show core test coverage"
@@ -173,12 +184,17 @@ end
 
 desc "show more test coverage"
 task "cov:more" do
-  sh "lemon -Ilib/more -c test/more"
+  sh "lemon -Ilib/core-uncommon -c test/core-uncommon"
+end
+
+desc "show standard test coverage"
+task "cov:tour" do
+  sh "lemon -Ilib/standard -c test/standard"
 end
 
-desc "show tour test coverage"
+desc "show supplemental test coverage"
 task "cov:tour" do
-  sh "lemon -Ilib/tour -c test/tour"
+  sh "lemon -Ilib/supplemental -c test/supplemental"
 end
 
 desc "show core coverage by file name"
@@ -219,25 +235,30 @@ end
 
 desc "run qed docs"
 task 'qed' do
-  sh "qed #{qed_flags} -Ilib/core:lib/more:lib/tour qed/core qed/more qed/tour"
+  sh "qed #{qed_flags} -I#{PATH} qed/core qed/core-uncommon qed/standard qed/supplemental"
 end
 
 desc "run core qed docs"
 task 'qed:core' do
-  sh "qed #{qed_flags} -Ilib/core qed/core"
+  sh "qed #{qed_flags} -I#{PATH} qed/core"
 end
 
 desc "run more qed docs"
 task 'qed:more' do
-  sh "qed #{qed_flags} -Ilib/core:lib/more qed/more"
+  sh "qed #{qed_flags} -I#{PATH} qed/core-uncommon"
 end
 
-desc "run tour qed docs"
-task 'qed:tour' do
-  sh "qed #{qed_flags} -Ilib/core:lib/tour qed/tour"
+desc "run standard qed docs"
+task 'qed:standard' do
+  sh "qed #{qed_flags} -I#{PATH} qed/standard"
 end
 
-desc "run core qed docs"
+desc "run supplemental qed docs"
+task 'qed:supplemental' do
+  sh "qed #{qed_flags} -I#{PATH} qed/supplemental"
+end
+
+desc "run core qed from code base"
 task 'qed:code' do
   sh "qed #{qed_flags} -c -Ilib/core lib/core"
 end
@@ -315,3 +336,25 @@ task :uninstall do
     puts "or 'gem install setup'."
   end
 end
+
+
+#
+# CHECK CHERRY PICKING
+# ----------------------------------------------------------------------------
+
+namespace :check do
+
+  desc 'check cherry pickability'
+  task 'cherry' do
+    files = Dir['lib/**/*.rb']
+    files.each do |file|
+      out = `ruby -Ilib #{file}`
+      if out != ''
+        puts file
+        puts out
+      end
+    end
+  end
+
+end
+

data/VERSION

@@ -0,0 +1 @@
+2.9.1

data/lib/core-uncommon/facets/array/median.rb

@@ -0,0 +1,17 @@
+require 'facets/array/percentile'
+
+class Array
+
+  # Returns the median for the array; nil if array is empty.
+  #
+  # NOTE: This is not (presently) a common core extension and is not
+  # loaded automatically when using <code>require 'facets'</code>.
+  #--
+  # TODO: Does Array#median belong in a math-oriented library?
+  #++
+  def median
+    percentile(50)
+  end
+
+end
+

data/lib/core-uncommon/facets/array/op_pow.rb

@@ -0,0 +1,9 @@
+require 'facets/array/product'
+
+class Array
+  # Array#** is an alias for Array#product.
+  #
+  # NOTE: This is not (presently) a common core extension and is not
+  # loaded automatically when using <code>require 'facets'</code>.
+  alias_method :**, :product
+end

data/lib/{tour → core-uncommon}/facets/array/percentile.rb

@@ -7,6 +7,9 @@ class Array
   #
   # Algorithm from NIST[http://www.itl.nist.gov/div898/handbook/prc/section2/prc252.htm]
   #
+  # NOTE: This is not (presently) a common core extension and is not
+  # loaded automatically when using <code>require 'facets'</code>.
+  #
   # CREDT: ?
 
   def percentile(p)

data/lib/{tour → core-uncommon}/facets/class/preallocate.rb

@@ -26,6 +26,9 @@ class Class
   # of the class heirarchy instead. For this reason, this method has been
   # named #preallocate, rather than #prepend.
   #
+  # NOTE: This is not (presently) a common core extension and is not
+  # loaded automatically when using <code>require 'facets'</code>.
+  #
   # CREDIT: Trans
 
   def preallocate(aspect)

data/lib/core-uncommon/facets/enumerable/has.rb

@@ -0,0 +1,22 @@
+module Enumerable
+  
+  # The same as #include?() but equality is tested using ===.
+  # 
+  #   [1, 2, "a"].has?(2)       #=> true
+  #   [1, 2, "a"].has?(String)  #=> true
+  #   [1, 2, "a"].has?(3)       #=> false
+  # 
+  # NOTE: This is not (presently) a common core extension and is not
+  # loaded automatically when using <code>require 'facets'</code>.
+  #
+  # TODO: Perhaps #matches? would be a better name?
+  #
+  # CREDIT: Lavir the Whiolet
+  def has?(what)
+    any? { |x| what === x }
+  end
+  
+  # Alias for #has?
+  alias have? has?
+  
+end

data/lib/core-uncommon/facets/enumerable/have.rb

@@ -0,0 +1 @@
+require 'facets/enumerable/has'

data/lib/{tour → core-uncommon}/facets/integer/roman.rb

@@ -21,6 +21,9 @@ class Integer
   ] unless const_defined?(:ROMAN_VALUES)
 
   # Converts this integer to a roman numeral.
+  #
+  # NOTE: This is not (presently) a common core extension and is not
+  # loaded automatically when using <code>require 'facets'</code>.
   def roman
     int = self
     #return nil if integer > ROMAN_MAX
@@ -45,6 +48,9 @@ class String
 
   # Considers string a Roman numeral numeral,
   # and converts it to the corresponding integer.
+  #
+  # NOTE: This is not (presently) a common core extension and is not
+  # loaded automatically when using <code>require 'facets'</code>.
   def roman
     roman = upcase
     raise unless roman?
@@ -60,6 +66,9 @@ class String
   end
 
   # Returns true iif the subject is a valid Roman numeral.
+  #
+  # NOTE: This is not (presently) a common core extension and is not
+  # loaded automatically when using <code>require 'facets'</code>.
   def roman?
     ROMAN =~ upcase
   end

data/lib/{tour → core-uncommon}/facets/kernel/demo.rb

@@ -15,6 +15,9 @@ module Kernel
   #
   # TODO: Is there a way to do this without the eval string in block?
   # Preferably just a block and no string.
+  #
+  # NOTE: This is not (presently) a common core extension and is not
+  # loaded automatically when using <code>require 'facets'</code>.
 
   def demo(out=$stdout,&block)
     out << sprintf("%-25s#=>  %s\n", expr = block.call, eval(expr, block.binding).inspect)

data/lib/{tour → core-uncommon}/facets/kernel/eigenclass.rb

@@ -8,6 +8,9 @@ module Kernel
   # unclasped and bearing north toward chilled shrimp.
   # I know what my Hallowe’en pumpkin is going to say.
   #
+  # NOTE: This is not (presently) a common core extension and is not
+  # loaded automatically when using <code>require 'facets'</code>.
+  #
   # CREDIT: WhyTheLuckyStiff
 
   def eigenclass