ruby-nuggets 0.4.5 → 0.5.0

data/README

@@ -2,7 +2,7 @@
 
 == VERSION
 
-This documentation refers to ruby-nuggets version 0.4.5
+This documentation refers to ruby-nuggets version 0.5.0
 
 
 == DESCRIPTION

data/Rakefile

@@ -19,12 +19,13 @@ Hen.lay! {{
   }
 }}
 
-desc "Run all examples"
-task :examples do
-  ruby = Config::CONFIG.values_at('RUBY_INSTALL_NAME', 'EXEEXT').join
+desc "Run all specs in isolation"
+task 'spec:isolated' do
+  ARGV.delete('spec:isolated')
+  ARGV.unshift('spec')
 
-  Dir['lib/nuggets/*/**/*.rb'].each { |file|
-    puts ">>>>> #{file} <<<<<"
-    system(ruby, '-I', 'lib', file)
+  Dir['spec/*/**/*_spec.rb'].each { |spec|
+    ENV['SPEC'] = spec
+    system($0, *ARGV)
   }
 end

data/lib/nuggets/all.rb

@@ -29,6 +29,8 @@ base = File.dirname(__FILE__)
 base_re = Regexp.escape(base)
 
 Dir[File.join(base, %w[* ** *.rb])].sort.each { |path|
+  next if path =~ /_mixin\.rb\z/
+
   ext_re = Regexp.escape(File.extname(path))
   require path.sub(/#{base_re}(.*)#{ext_re}/, 'nuggets\1')
 }

data/lib/nuggets/all_mixins.rb

@@ -0,0 +1,34 @@
+#--
+###############################################################################
+#                                                                             #
+# A component of ruby-nuggets, some extensions to the Ruby programming        #
+# language.                                                                   #
+#                                                                             #
+# Copyright (C) 2007-2009 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@uni-koeln.de>                                    #
+#                                                                             #
+# ruby-nuggets is free software; you can redistribute it and/or modify it     #
+# under the terms of the GNU General Public License as published by the Free  #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# ruby-nuggets is distributed in the hope that it will be useful, but WITHOUT #
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or       #
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for    #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU General Public License along     #
+# with ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.              #
+#                                                                             #
+###############################################################################
+#++
+
+base = File.dirname(__FILE__)
+base_re = Regexp.escape(base)
+
+Dir[File.join(base, %w[* ** *_mixin.rb])].sort.each { |path|
+  ext_re = Regexp.escape(File.extname(path))
+  require path.sub(/#{base_re}(.*)#{ext_re}/, 'nuggets\1')
+}

data/lib/nuggets/enumerable/all_any_extended.rb

@@ -37,10 +37,8 @@ module Enumerable
   # Adds the ability to pass an +object+ instead of a block, which will then
   # be tested against each item in _enum_ according to +operator+, defaulting
   # to :===.
-  def all?(object = default = Object.new, operator = :===)
-    _nuggets_original_all?(&block_given? ?
-      _block_for_all_any_extended(object, default, operator) { |*a| yield(*a) } :
-      _block_for_all_any_extended(object, default, operator))
+  def all?(object = default = Object.new, operator = :===, &block)
+    _nuggets_original_all?(&_block_for_all_any_extended(object, default, operator, &block))
   end
 
   # call-seq:
@@ -50,22 +48,19 @@ module Enumerable
   # Adds the ability to pass an +object+ instead of a block, which will then
   # be tested against each item in _enum_ according to +operator+, defaulting
   # to :===.
-  def any?(object = default = Object.new, operator = :===)
-    _nuggets_original_any?(&block_given? ?
-      _block_for_all_any_extended(object, default, operator) { |*a| yield(*a) } :
-      _block_for_all_any_extended(object, default, operator))
+  def any?(object = default = Object.new, operator = :===, &block)
+    _nuggets_original_any?(&_block_for_all_any_extended(object, default, operator, &block))
   end
 
   private
 
   # Common argument processing for extended versions of #all? and #any?.
-  def _block_for_all_any_extended(object, default, operator)
+  def _block_for_all_any_extended(object, default, operator, &block)
     if default.nil?
-      raise ArgumentError, "both block and object argument given", caller(1) if block_given?
-
-      lambda { |item| object.send(operator, item) }
-    elsif block_given?
-      lambda { |item| yield item }
+      raise ArgumentError, "both block and object argument given", caller(1) if block
+      lambda { |*a| object.send(operator, *a) }
+    else
+      block
     end
   end
 

data/lib/nuggets/enumerable/minmax.rb

@@ -27,6 +27,11 @@
 
 module Enumerable
 
+  alias_method :_nuggets_original_minmax_by, :minmax_by if method_defined?(:minmax_by)
+  alias_method :_nuggets_original_min_by,    :min_by    if method_defined?(:min_by)
+  alias_method :_nuggets_original_max_by,    :max_by    if method_defined?(:max_by)
+  alias_method :_nuggets_original_minmax,    :minmax    if method_defined?(:minmax)
+
   alias_method :_nuggets_original_max, :max
   alias_method :_nuggets_original_min, :min
 

data/lib/nuggets/file/which.rb

@@ -1,74 +1,5 @@
-#--
-###############################################################################
-#                                                                             #
-# A component of ruby-nuggets, some extensions to the Ruby programming        #
-# language.                                                                   #
-#                                                                             #
-# Copyright (C) 2007-2008 Jens Wille                                          #
-#                                                                             #
-# Authors:                                                                    #
-#     Jens Wille <jens.wille@uni-koeln.de>                                    #
-#                                                                             #
-# ruby-nuggets is free software; you can redistribute it and/or modify it     #
-# under the terms of the GNU General Public License as published by the Free  #
-# Software Foundation; either version 3 of the License, or (at your option)   #
-# any later version.                                                          #
-#                                                                             #
-# ruby-nuggets is distributed in the hope that it will be useful, but WITHOUT #
-# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or       #
-# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for    #
-# more details.                                                               #
-#                                                                             #
-# You should have received a copy of the GNU General Public License along     #
-# with ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.              #
-#                                                                             #
-###############################################################################
-#++
+require 'nuggets/file/which_mixin'
 
 class File
-
-  class << self
-
-    # call-seq:
-    #   File.which(executable) => aString or nil
-    #
-    # Returns the full path to +executable+, or +nil+ if not found in PATH.
-    # Inspired by Gnuplot.which -- thx, Gordon!
-    def which(executable)
-      return executable if executable?(executable)
-
-      if path = ENV['PATH']
-        path.split(PATH_SEPARATOR).each { |dir|
-          candidate = join(expand_path(dir), executable)
-          return candidate if executable?(candidate)
-        }
-      end
-
-      nil
-    end
-
-    # call-seq:
-    #   File.which_command(commands) => aString or nil
-    #
-    # Returns the first of +commands+ that is executable.
-    def which_command(commands)
-      commands.find { |command| which(command[/\S+/]) }
-    end
-
-  end
-
-end
-
-if $0 == __FILE__
-  %w[cat dog rat gcc /usr/bin/X11/gcc].each { |e|
-    p [e, File.which(e)]
-  }
-
-  c = [
-    'unison --args source target',
-    'rsync --args source target',
-    'scp --args source target'
-  ]
-  p c
-  p File.which_command(c)
+  extend Nuggets::File::WhichMixin
 end

data/lib/nuggets/file/which_mixin.rb

@@ -0,0 +1,60 @@
+#--
+###############################################################################
+#                                                                             #
+# A component of ruby-nuggets, some extensions to the Ruby programming        #
+# language.                                                                   #
+#                                                                             #
+# Copyright (C) 2007-2008 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@uni-koeln.de>                                    #
+#                                                                             #
+# ruby-nuggets is free software; you can redistribute it and/or modify it     #
+# under the terms of the GNU General Public License as published by the Free  #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# ruby-nuggets is distributed in the hope that it will be useful, but WITHOUT #
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or       #
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for    #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU General Public License along     #
+# with ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.              #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class File
+    module WhichMixin
+
+  # call-seq:
+  #   File.which(executable) => aString or nil
+  #
+  # Returns the full path to +executable+, or +nil+ if not found in PATH.
+  # Inspired by Gnuplot.which -- thx, Gordon!
+  def which(executable)
+    return executable if executable?(executable)
+
+    if path = ENV['PATH']
+      path.split(::File::PATH_SEPARATOR).each { |dir|
+        candidate = join(expand_path(dir), executable)
+        return candidate if executable?(candidate)
+      }
+    end
+
+    nil
+  end
+
+  # call-seq:
+  #   File.which_command(commands) => aString or nil
+  #
+  # Returns the first of +commands+ that is executable.
+  def which_command(commands)
+    commands.find { |command| which(command[/\S+/]) }
+  end
+
+    end
+  end
+end

data/lib/nuggets/integer/length.rb

@@ -0,0 +1,5 @@
+require 'nuggets/integer/length_mixin'
+
+class Integer
+  include Nuggets::Integer::LengthMixin
+end

data/lib/nuggets/integer/length_mixin.rb

@@ -0,0 +1,50 @@
+#--
+###############################################################################
+#                                                                             #
+# A component of ruby-nuggets, some extensions to the Ruby programming        #
+# language.                                                                   #
+#                                                                             #
+# Copyright (C) 2007-2009 Jens Wille                                          #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@uni-koeln.de>                                    #
+#                                                                             #
+# ruby-nuggets is free software; you can redistribute it and/or modify it     #
+# under the terms of the GNU General Public License as published by the Free  #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# ruby-nuggets is distributed in the hope that it will be useful, but WITHOUT #
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or       #
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for    #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU General Public License along     #
+# with ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.              #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class Integer
+    module LengthMixin
+
+  # call-seq:
+  #   int.length => anInteger
+  #
+  # Returns the length of _int_.
+  def length
+    to_s.length
+  end
+
+  # call-seq:
+  #   int.digit_count => anInteger
+  #
+  # Returns the digit count of _int_. [ruby-core:22383]
+  def digit_count
+    abs.length
+  end
+
+    end
+  end
+end

data/lib/nuggets/object/blank.rb

@@ -1,119 +1,20 @@
-#--
-###############################################################################
-#                                                                             #
-# A component of ruby-nuggets, some extensions to the Ruby programming        #
-# language.                                                                   #
-#                                                                             #
-# Copyright (C) 2007 Jens Wille                                               #
-#                                                                             #
-# Authors:                                                                    #
-#     Jens Wille <jens.wille@uni-koeln.de>                                    #
-#                                                                             #
-# ruby-nuggets is free software; you can redistribute it and/or modify it     #
-# under the terms of the GNU General Public License as published by the Free  #
-# Software Foundation; either version 3 of the License, or (at your option)   #
-# any later version.                                                          #
-#                                                                             #
-# ruby-nuggets is distributed in the hope that it will be useful, but WITHOUT #
-# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or       #
-# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for    #
-# more details.                                                               #
-#                                                                             #
-# You should have received a copy of the GNU General Public License along     #
-# with ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.              #
-#                                                                             #
-###############################################################################
-#++
+require 'nuggets/object/blank_mixin'
 
 class Object
-
-  # call-seq:
-  #   object.blank? => true or false
-  #
-  # Basically a short-cut to <tt>object.nil? || object.empty?</tt>.
-  def blank?(*modifiers)
-    if block_given?
-      return true if yield(dup).blank?
-    end
-
-    if modifiers.empty?
-      respond_to?(:empty?) ? empty? : !self
-    else
-      return true if blank?
-
-      modifiers.each { |modifier|
-        if respond_to?(modifier)
-          if modifier.to_s =~ /\?\z/
-            return true if send(modifier)
-          else
-            return true if send(modifier).blank?
-          end
-        end
-      }
-
-      false
-    end
-  end
-
-  # call-seq:
-  #   object.void? => true or false
-  #
-  # Adds white-space strings, 0 and arrays of +nil+ objects to the list of
-  # blank objects.
-  def void?
-    blank?(:zero?, :strip, :compact)
-  end
-  alias_method :vain?, :void?
-
+  include Nuggets::Object::BlankMixin
 end
 
 class Array
-
-  # call-seq:
-  #   array.vain? => true or false
-  #
-  # Returns true if all of _array_'s elements are themselves vain.
-  def vain?
-    blank? { |a| a.delete_if { |i| i.vain? } }
-  end
-
+  include Nuggets::Array::BlankMixin
 end
 
 class Hash
-
-  # call-seq:
-  #   hash.vain? => true or false
-  #
-  # Returns true if all of _hash_'s values are themselves vain.
-  def vain?
-    blank? { |h| h.delete_if { |_, v| v.vain? } }
-  end
-
-end
-
-class String
-  if public_instance_methods(false).include?(method = 'blank?')
-    # remove incompatible implementation added by utility_belt/language_greps.rb
-    remove_method method
-  end
+  include Nuggets::Hash::BlankMixin
 end
 
-if $0 == __FILE__
-  ['', ' ', 's', 0, 1, nil, true, false, [], [nil], {}].each { |o|
-    p o
-    p o.blank?
-    p o.void?
-  }
-
-  o = ['', [], [nil], {}]
-  p o
-  p o.blank?
-  p o.void?
-  p o.vain?
-
-  o = { :x => nil, :y => [], :z => { :zz => nil } }
-  p o
-  p o.blank?
-  p o.void?
-  p o.vain?
-end
+#class String
+#  if public_instance_methods(false).include?(method = 'blank?')
+#    # remove incompatible implementation added by utility_belt/language_greps.rb
+#    remove_method method
+#  end
+#end

data/lib/nuggets/object/blank_mixin.rb

@@ -0,0 +1,100 @@
+#--
+###############################################################################
+#                                                                             #
+# A component of ruby-nuggets, some extensions to the Ruby programming        #
+# language.                                                                   #
+#                                                                             #
+# Copyright (C) 2007 Jens Wille                                               #
+#                                                                             #
+# Authors:                                                                    #
+#     Jens Wille <jens.wille@uni-koeln.de>                                    #
+#                                                                             #
+# ruby-nuggets is free software; you can redistribute it and/or modify it     #
+# under the terms of the GNU General Public License as published by the Free  #
+# Software Foundation; either version 3 of the License, or (at your option)   #
+# any later version.                                                          #
+#                                                                             #
+# ruby-nuggets is distributed in the hope that it will be useful, but WITHOUT #
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or       #
+# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for    #
+# more details.                                                               #
+#                                                                             #
+# You should have received a copy of the GNU General Public License along     #
+# with ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.              #
+#                                                                             #
+###############################################################################
+#++
+
+module Nuggets
+  class Object
+    module BlankMixin
+
+  # call-seq:
+  #   object.blank? => true or false
+  #
+  # Basically a short-cut to <tt>object.nil? || object.empty?</tt>.
+  def blank?(*modifiers)
+    if block_given?
+      return true if yield(dup).blank?
+    end
+
+    if modifiers.empty?
+      respond_to?(:empty?) ? empty? : !self
+    else
+      return true if blank?
+
+      modifiers.each { |modifier|
+        if respond_to?(modifier)
+          if modifier.to_s =~ /\?\z/
+            return true if send(modifier)
+          else
+            return true if send(modifier).blank?
+          end
+        end
+      }
+
+      false
+    end
+  end
+
+  # call-seq:
+  #   object.void? => true or false
+  #
+  # Adds white-space strings, 0 and arrays of +nil+ objects to the list of
+  # blank objects.
+  def void?
+    blank?(:zero?, :strip, :compact)
+  end
+  alias_method :vain?, :void?
+
+    end
+  end
+
+  class Array
+    module BlankMixin
+
+  # call-seq:
+  #   array.vain? => true or false
+  #
+  # Returns true if all of _array_'s elements are themselves vain.
+  def vain?
+    blank? { |a| a.delete_if { |i| i.vain? } }
+  end
+
+    end
+  end
+
+  class Hash
+    module BlankMixin
+
+  # call-seq:
+  #   hash.vain? => true or false
+  #
+  # Returns true if all of _hash_'s values are themselves vain.
+  def vain?
+    blank? { |h| h.delete_if { |_, v| v.vain? } }
+  end
+
+    end
+  end
+end

data/lib/nuggets/object/boolean.rb

@@ -1,69 +1,5 @@
-#--
-###############################################################################
-#                                                                             #
-# A component of ruby-nuggets, some extensions to the Ruby programming        #
-# language.                                                                   #
-#                                                                             #
-# Copyright (C) 2007-2008 Jens Wille                                          #
-#                                                                             #
-# Authors:                                                                    #
-#     Jens Wille <jens.wille@uni-koeln.de>                                    #
-#                                                                             #
-# ruby-nuggets is free software; you can redistribute it and/or modify it     #
-# under the terms of the GNU General Public License as published by the Free  #
-# Software Foundation; either version 3 of the License, or (at your option)   #
-# any later version.                                                          #
-#                                                                             #
-# ruby-nuggets is distributed in the hope that it will be useful, but WITHOUT #
-# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or       #
-# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for    #
-# more details.                                                               #
-#                                                                             #
-# You should have received a copy of the GNU General Public License along     #
-# with ruby-nuggets. If not, see <http://www.gnu.org/licenses/>.              #
-#                                                                             #
-###############################################################################
-#++
+require 'nuggets/object/boolean_mixin'
 
 class Object
-
-  # call-seq:
-  #   object.boolean? => true or false
-  #
-  # 
-  def boolean?
-    is_a?(TrueClass) || is_a?(FalseClass)
-  end
-
-  # call-seq:
-  #   object.negate => true or false
-  #
-  #
-  def negate
-    !self
-  end
-
-  alias_method :false?, :negate
-
-  # call-seq:
-  #   object.to_bool => true or false
-  #
-  #
-  def to_bool
-    !!self
-  end
-
-  alias_method :true?, :to_bool
-
-end
-
-if $0 == __FILE__
-  [0, 1, nil, '', 'abc', true, false, Class, Object.new].each { |o|
-    p o
-    p o.boolean?
-    p o.negate
-    p o.to_bool
-    p o.true?
-    p o.false?
-  }
+  include Nuggets::Object::BooleanMixin
 end