ruby-nuggets 0.3.6.294 → 0.4.0

data/README

@@ -2,12 +2,40 @@
 
 == VERSION
 
-This documentation refers to ruby-nuggets version 0.3.6
+This documentation refers to ruby-nuggets version 0.4.0
 
 
 == DESCRIPTION
 
-TODO: well, the description... ;-)
+ruby-nuggets provides a collection of extensions to Ruby core classes. In
+its effort, it's similar to projects like Facets[http://facets.rubyforge.org]
+and Extensions[http://extensions.rubyforge.org] (or even
+Labrador[http://rubyforge.org/projects/labrador/]), though not as ambitious ;-)
+This is simply where I put stuff that I need on a more or less regular basis
+or that struck me as interesting while surfing the web, reading books, or
+following discussions on ruby-talk.
+
+There are several ways to get at the nuggets you're interested in:
+
+  # The usual way: Just require() what you need
+  require 'nuggets/object/singleton_class'
+
+  # The more fancy way ;-) (see the documentation of Nuggets() for more examples)
+  require 'nuggets'
+  Nuggets(:object => 'singleton_class', :string => %w[nsub sub_with_md])
+
+  # Finally, get everything there is...
+  require 'nuggets/all'
+
+Please be aware that some of the things herein might not work as expected or
+cause other libraries to misbehave. Use at your own risk!
+
+
+== LINKS
+
+* <http://prometheus.rubyforge.org/ruby-nuggets>
+* <http://prometheus.rubyforge.org/svn/scratch/ruby-nuggets>
+* <http://github.com/blackwinter/ruby-nuggets>
 
 
 == AUTHORS

data/lib/nuggets/all.rb

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

data/lib/nuggets/array/format.rb

@@ -25,7 +25,7 @@
 ###############################################################################
 #++
 
-require File.join(File.dirname(__FILE__), 'combination')
+require 'nuggets/array/combination'
 
 class Array
 

data/lib/nuggets/array/monotone.rb

@@ -28,12 +28,12 @@
 class Array
 
   # call-seq:
-  #   array.monotone?(op) => true or false
+  #   array.monotone?(operator) => true or false
   #
-  # Check whether _array_ is monotone according to operator +op+.
-  def monotone?(op)
+  # Check whether _array_ is monotone according to +operator+.
+  def monotone?(operator)
     inject { |a, b|
-      return false unless a.send(op, b)
+      return false unless a.send(operator, b)
       b
     }
 

data/lib/nuggets/array/only.rb

@@ -28,7 +28,7 @@
 class Array
 
   # call-seq:
-  #   array.only([relax]) => anObject
+  #   array.only(relax = true or false) => anObject
   #
   # Returns the only element of _array_. Raises an IndexError if _array_'s
   # size is not 1, unless +relax+ is true.

data/lib/nuggets/array/shuffle.rb

@@ -101,8 +101,8 @@ if $0 == __FILE__
   a.shuffle!
   p a
 
-  require File.join(File.dirname(__FILE__), '..', 'integer', 'factorial')
-  require File.join(File.dirname(__FILE__), '..', 'enumerable', 'minmax')
+  require 'nuggets/integer/factorial'
+  require 'nuggets/enumerable/minmax'
 
   a = %w[a b c]
   n = 100_000

data/lib/nuggets/array/to_hash.rb

@@ -25,7 +25,7 @@
 ###############################################################################
 #++
 
-require File.join(File.dirname(__FILE__), 'flatten_once')
+require 'nuggets/array/flatten_once'
 
 class Array
 
@@ -39,55 +39,27 @@ class Array
   # <tt>hash.to_a.to_h == hash</tt>). Otherwise, maps each element of
   # _array_ to +value+ or the result of the block.
   #
-  # NOTE: This is the "nice" version. For a more speed-optimized one,
-  # use #to_hash_opt.
-  #
   # Examples:
   #   [[0, 0], [1, [2, 3]]].to_h  #=> { 0 => 0, 1 => [2, 3] }
   #   %w[a b c d].to_h            #=> { "a" => "b", "c" => "d" }
   #   %w[a b c d].to_h(1)         #=> { "a" => 1, "b" => 1, "c" => 1, "d" => 1 }
   #   %w[a b].to_h { |e| e * 2 }  #=> { "a" => "aa", "b" => "bb" }
-  def to_hash(value = default = Object.new, &block)
-    if block ||= value != default && lambda { value }
-      inject({}) { |hash, element|
-        hash.update(element => block[element])
-      }
-    else
-      Hash[*flatten_once]
-    end
-  end
-  alias_method :to_h, :to_hash
+  def to_hash(value = default = Object.new)
+    hash = {}
 
-  # call-seq:
-  #   array.to_hash_opt => aHash
-  #   array.to_hash_opt(value) => aHash
-  #   array.to_hash_opt { |element| ... } => aHash
-  #
-  # Same as #to_hash, but slightly optimized for speed. To use this one instead
-  # of #to_hash: <tt>Array.send(:alias_method, :to_h, :to_hash_opt)</tt>.
-  #
-  # Benchmark (array = (1..20).to_a, N = 100_000):
-  #                            user     system      total        real
-  #   to_hash: plain       4.820000   0.560000   5.380000 (  5.600390)
-  #   to_hash: value      12.910000   0.930000  13.840000 ( 13.938352)
-  #   to_hash: block      13.590000   1.180000  14.770000 ( 14.810804)
-  #   to_hash_opt: plain   4.910000   0.470000   5.380000 (  5.416949)
-  #   to_hash_opt: value   2.170000   0.390000   2.560000 (  2.609034)
-  #   to_hash_opt: block   7.090000   0.880000   7.970000 (  8.109180)
-  def to_hash_opt(value = default = Object.new, &block)
-    if block
-      hash = {}
-      each { |element| hash[element] = block[element] }
-      hash
-    elsif value != default
-      hash = {}
+    if block_given?
+      raise ArgumentError, "both block and value argument given" if default.nil?
+
+      each { |element| hash[element] = yield element }
+    elsif default.nil?
       each { |element| hash[element] = value }
-      hash
     else
-      Hash[*flatten_once]
+      return Hash[*flatten_once]
     end
+
+    hash
   end
-  #alias_method :to_h, :to_hash_opt
+  alias_method :to_h, :to_hash
 
 end
 

data/lib/nuggets/enumerable/agrep.rb

@@ -25,8 +25,16 @@
 ###############################################################################
 #++
 
-require 'rubygems'
-require 'amatch'
+begin
+  require 'rubygems'
+rescue LoadError
+end
+
+begin
+  require 'amatch'
+rescue LoadError
+  warn "Couldn't load amatch..." if $VERBOSE
+end
 
 module Enumerable
 
@@ -46,13 +54,15 @@ module Enumerable
   # - Only works with string elements in _enum_. (Calls +to_s+ on each element)
   # - The cost for individual error types (substitution, insertion, deletion)
   #   cannot be adjusted. 
-  def agrep(pattern, distance = 0, &block)
+  def agrep(pattern, distance = 0)
+    raise 'Amatch not available!' unless defined?(Amatch)
+
     pattern = pattern.source if pattern.is_a?(Regexp)
 
     amatch  = Amatch::Levenshtein.new(pattern)
     matches = select { |obj| amatch.search(obj.to_s) <= distance }
 
-    block ? matches.map(&block) : matches
+    block_given? ? matches.map { |match| yield match } : matches
   end
 
 end

data/lib/nuggets/enumerable/all_any_extended.rb

@@ -37,8 +37,10 @@ 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 = :===, &block)
-    _nuggets_original_all?(&_block_for_all_any_extended(object, default, operator, block))
+  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))
   end
 
   # call-seq:
@@ -48,20 +50,22 @@ 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 = :===, &block)
-    _nuggets_original_any?(&_block_for_all_any_extended(object, default, operator, block))
+  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))
   end
 
   private
 
   # Common argument processing for extended versions of #all? and #any?.
-  def _block_for_all_any_extended(object, default, operator, block)
+  def _block_for_all_any_extended(object, default, operator)
     if default.nil?
-      raise ArgumentError, "both block and object argument given", caller(1) if block
+      raise ArgumentError, "both block and object argument given", caller(1) if block_given?
 
       lambda { |item| object.send(operator, item) }
-    else
-      block
+    elsif block_given?
+      lambda { |item| yield item }
     end
   end
 

data/lib/nuggets/enumerable/minmax.rb

@@ -82,8 +82,9 @@ module Enumerable
   #
   # Maximum #minmax. If +what+ is omitted, or nil, the original Enumerable#max
   # is called.
-  def max(what = nil, &block)
-    what ? minmax(:max, what) : _nuggets_original_max(&block)
+  def max(what = nil)
+    what ? minmax(:max, what) : block_given? ?
+      _nuggets_original_max { |*a| yield(*a) } : _nuggets_original_max
   end
 
   # call-seq:
@@ -91,8 +92,9 @@ module Enumerable
   #
   # Minimum #minmax. If +what+ is omitted, or nil, the original Enumerable#min
   # is called.
-  def min(what = nil, &block)
-    what ? minmax(:min, what) : _nuggets_original_min(&block)
+  def min(what = nil)
+    what ? minmax(:min, what) : block_given? ?
+      _nuggets_original_min { |*a| yield(*a) } : _nuggets_original_min
   end
 
 end

data/lib/nuggets/file/which.rb

@@ -44,7 +44,7 @@ class File
         }
       end
 
-      return nil
+      nil
     end
 
     # call-seq:

data/lib/nuggets/hash/at.rb

@@ -25,7 +25,7 @@
 ###############################################################################
 #++
 
-require File.join(File.dirname(__FILE__), '..', 'array', 'rand')
+require 'nuggets/array/rand'
 
 class Hash
 

data/lib/nuggets/hash/in_order.rb

@@ -25,7 +25,7 @@
 ###############################################################################
 #++
 
-require File.join(File.dirname(__FILE__), '..', 'array', 'in_order')
+require 'nuggets/array/in_order'
 
 class Hash
 

data/lib/nuggets/hash/insert.rb

@@ -47,8 +47,8 @@ class Hash
   #   hash.insert!(other) { |key, old_value, new_value| ... } => hash
   #
   # Destructive version of #insert.
-  def insert!(other, &block)
-    replace insert(other, &block)
+  def insert!(other)
+    replace block_given? ? insert(other) { |*a| yield(*a) } : insert(other)
   end
 
 end

data/lib/nuggets/hash/only.rb

@@ -25,12 +25,12 @@
 ###############################################################################
 #++
 
-require File.join(File.dirname(__FILE__), 'at')
+require 'nuggets/hash/at'
 
 class Hash
 
   # call-seq:
-  #   hash.only([relax]) => aHash
+  #   hash.only(relax = true or false) => aHash
   #
   # Returns the only key/value pair of _hash_. Raises an IndexError if _hash_'s
   # size is not 1, unless +relax+ is true.
@@ -42,7 +42,7 @@ class Hash
   end
 
   # call-seq:
-  #   hash.only_pair([relax]) => anArray
+  #   hash.only_pair(relax = true or false) => anArray
   #
   # Returns the only key/value pair of _hash_ as an array. Raises an IndexError
   # if _hash_'s size is not 1, unless +relax+ is true.

data/lib/nuggets/integer/factorial.rb

@@ -45,8 +45,8 @@ class Integer
   # Calculate the factorial of _int_ with the help of memoization (Which gives
   # a considerable speedup for repeated calculations -- at the cost of memory).
   #
-  # WARNING: Don't try to calculate the factorial this way for a too large
-  # integer! This might well bring your system down to its knees... ;-)
+  # WARNING: Don't try to calculate the factorial this way for "large"
+  # integers! This might well bring your system down to its knees... ;-)
   def factorial_memoized
     FACTORIAL[self] ||= (1..self).inject { |f, i| FACTORIAL[i] ||= f * i }
   end

data/lib/nuggets/io/agrep.rb

@@ -25,7 +25,7 @@
 ###############################################################################
 #++
 
-require File.join(File.dirname(__FILE__), '..', 'enumerable', 'agrep')
+require 'nuggets/enumerable/agrep'
 
 class IO
 

data/lib/nuggets/io/modes.rb

@@ -39,8 +39,8 @@ class IO
     #
     # Opens +name+ with mode +r+. NOTE: With no associated block,
     # acts like the original IO::read, not like IO::new.
-    def read(name, *args, &block)
-      return _nuggets_original_read(name, *args) unless block
+    def read(name, *args)
+      return _nuggets_original_read(name, *args) unless block_given?
 
       case args.size
         when 0
@@ -56,7 +56,7 @@ class IO
           raise ArgumentError, "wrong number of arguments (#{args.size + 1} for 1-2)"
       end
 
-      open_with_mode(name, 'r', binary, &block)
+      open_with_mode(name, 'r', binary) { |*a| yield(*a) }
     end
 
     # call-seq:
@@ -64,8 +64,10 @@ class IO
     #   IO.write(name, binary = false) { |io| ... } => anObject
     #
     # Opens +name+ with mode +w+.
-    def write(name, binary = false, &block)
-      open_with_mode(name, 'w', binary, &block)
+    def write(name, binary = false)
+      block_given? ?
+        open_with_mode(name, 'w', binary) { |*a| yield(*a) } :
+        open_with_mode(name, 'w', binary)
     end
 
     # call-seq:
@@ -73,8 +75,10 @@ class IO
     #   IO.append(name, binary = false) { |io| ... } => anObject
     #
     # Opens +name+ with mode +a+.
-    def append(name, binary = false, &block)
-      open_with_mode(name, 'a', binary, &block)
+    def append(name, binary = false)
+      block_given? ?
+        open_with_mode(name, 'a', binary) { |*a| yield(*a) } :
+        open_with_mode(name, 'a', binary)
     end
 
     # call-seq:
@@ -82,8 +86,10 @@ class IO
     #   IO.read_write(name, binary = false) { |io| ... } => anObject
     #
     # Opens +name+ with mode <tt>r+</tt>.
-    def read_write(name, binary = false, &block)
-      open_with_mode(name, 'r+', binary, &block)
+    def read_write(name, binary = false)
+      block_given? ?
+        open_with_mode(name, 'r+', binary) { |*a| yield(*a) } :
+        open_with_mode(name, 'r+', binary)
     end
 
     # call-seq:
@@ -91,8 +97,10 @@ class IO
     #   IO.write_read(name, binary = false) { |io| ... } => anObject
     #
     # Opens +name+ with mode <tt>w+</tt>.
-    def write_read(name, binary = false, &block)
-      open_with_mode(name, 'w+', binary, &block)
+    def write_read(name, binary = false)
+      block_given? ?
+        open_with_mode(name, 'w+', binary) { |*a| yield(*a) } :
+        open_with_mode(name, 'w+', binary)
     end
 
     # call-seq:
@@ -100,16 +108,18 @@ class IO
     #   IO.append_read(name, binary = false) { |io| ... } => anObject
     #
     # Opens +name+ with mode <tt>a+</tt>.
-    def append_read(name, binary = false, &block)
-      open_with_mode(name, 'a+', binary, &block)
+    def append_read(name, binary = false)
+      block_given? ?
+        open_with_mode(name, 'a+', binary) { |*a| yield(*a) } :
+        open_with_mode(name, 'a+', binary)
     end
 
     private
 
     # Just a helper to DRY things up.
-    def open_with_mode(name, mode, binary = false, &block)
+    def open_with_mode(name, mode, binary = false)
       mode << 'b' if binary
-      open(name, mode, &block)
+      block_given? ? open(name, mode) { |io| yield io } : open(name, mode)
     end
 
   end

data/lib/nuggets/numeric/between.rb

@@ -1,2 +1,2 @@
 # backwards compatibility
-require File.join(File.dirname(__FILE__), 'limit')
+require 'nuggets/numeric/limit'

data/lib/nuggets/object/blank.rb

@@ -42,12 +42,12 @@ class Object
       return true if blank?
 
       modifiers.each { |modifier|
-        next unless respond_to?(modifier)
-
-        if modifier.to_s[-1] == ??
-          return true if send(modifier)
-        else
-          return true if send(modifier).blank?
+        if respond_to?(modifier)
+          if modifier.to_s =~ /\?\z/
+            return true if send(modifier)
+          else
+            return true if send(modifier).blank?
+          end
         end
       }
 
@@ -86,11 +86,18 @@ class Hash
   #
   # Returns true if all of _hash_'s values are themselves vain.
   def vain?
-    blank? { |h| h.delete_if { |k, v| v.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
+end
+
 if $0 == __FILE__
   ['', ' ', 's', 0, 1, nil, true, false, [], [nil], {}].each { |o|
     p o

data/lib/nuggets/object/boolean.rb

@@ -0,0 +1,69 @@
+#--
+###############################################################################
+#                                                                             #
+# 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/>.              #
+#                                                                             #
+###############################################################################
+#++
+
+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?
+  }
+end

data/lib/nuggets/object/eigenclass.rb

@@ -1,2 +1,2 @@
 # whatever you prefer to call it...
-require File.join(File.dirname(__FILE__), 'singleton_class')
+require 'nuggets/singleton_class'

data/lib/nuggets/object/ghost_class.rb

@@ -1,2 +1,2 @@
 # whatever you prefer to call it...
-require File.join(File.dirname(__FILE__), 'singleton_class')
+require 'nuggets/singleton_class'

data/lib/nuggets/object/metaclass.rb

@@ -1,2 +1,2 @@
 # whatever you prefer to call it...
-require File.join(File.dirname(__FILE__), 'singleton_class')
+require 'nuggets/singleton_class'

data/lib/nuggets/object/singleton_class.rb

@@ -56,7 +56,7 @@ class Object
       return obj if self.equal?(obj.singleton_class)
     }
 
-    # if we got here it can't be a singleton class
+    # if we got here, it can't be a singleton class
     # or its singleton object doesn't exist anymore
     raise TypeError
   rescue TypeError
@@ -135,8 +135,10 @@ if $0 == __FILE__
 
   ###
 
-  class A; end
-  class B < A; end
+  class A      # :nodoc:
+  end
+  class B < A  # :nodoc:
+  end
 
   a = A.singleton_class
   b = B.singleton_class

data/lib/nuggets/object/uniclass.rb

@@ -1,2 +1,2 @@
 # whatever you prefer to call it...
-require File.join(File.dirname(__FILE__), 'singleton_class')
+require 'nuggets/singleton_class'

data/lib/nuggets/object/virtual_class.rb

@@ -1,2 +1,2 @@
 # whatever you prefer to call it...
-require File.join(File.dirname(__FILE__), 'singleton_class')
+require 'nuggets/singleton_class'

data/lib/nuggets/proc/bind.rb

@@ -25,8 +25,6 @@
 ###############################################################################
 #++
 
-require File.join(File.dirname(__FILE__), '..', 'object', 'singleton_class')
-
 class Proc
 
   # call-seq:
@@ -36,7 +34,7 @@ class Proc
   def bind(object)
     block, time = self, Time.now
 
-    object.singleton_class.class_eval {
+    (class << object; self; end).class_eval {
       method_name = "__bind_#{time.to_i}_#{time.usec}"
       define_method(method_name, &block)
 

data/lib/nuggets/string/msub.rb

@@ -25,7 +25,7 @@
 ###############################################################################
 #++
 
-require File.join(File.dirname(__FILE__), 'evaluate')
+require 'nuggets/string/evaluate'
 
 class String
 
@@ -43,7 +43,7 @@ class String
   # string or a regexp, +substitution+ may contain string expressions (cf.
   # #evaluate).
   def msub(*substitutions)
-    dup.msub!(*substitutions) || dup
+    (_dup = dup).msub!(*substitutions) || _dup
   end
 
   # call-seq:
@@ -62,7 +62,7 @@ class String
     }
 
     gsub!(Regexp.union(*keys)) { |match|
-      cache[match] ||= subs.find { |key,|
+      cache[match] ||= subs.find { |key, _|
         key =~ match
       }.last.evaluate(binding)
     }

data/lib/nuggets/string/nsub.rb

@@ -33,8 +33,11 @@ class String
   #
   # Returns a copy of _str_ with the _first_ +count+ occurrences of pattern
   # replaced with either +replacement+ or the value of the block.
-  def nsub(*args, &block)
-    dup.nsub!(*args, &block) || dup
+  def nsub(*args)
+    _dup = dup
+    (block_given? ?
+      _dup.nsub!(*args) { |*a| yield(*a) } :
+      _dup.nsub!(*args)) || _dup
   end
 
   # call-seq:
@@ -43,29 +46,24 @@ class String
   #
   # Performs the substitutions of #nsub in place, returning _str_, or +nil+ if
   # no substitutions were performed.
-  def nsub!(*args, &block)
+  def nsub!(*args)
+    pattern, i = args.first, 0
+
     case args.size
       when 2
-        pattern = args.shift
+        # Only +count+ given
+        count = args.last
 
-        # Only +count+ given; require block
-        count = *args
-        raise LocalJumpError, 'no block given' unless block_given?
+        gsub!(pattern) { |match| (i += 1) <= count ? yield(match) : match }
       when 3
-        pattern = args.shift
-
         # Both +replacement+ and +count+ given;
         # ignore block (just like String#gsub does)
-        replacement, count = *args
-        block = lambda { replacement }
+        replacement, count = args.values_at(1, 2)
+
+        gsub!(pattern) { |match| (i += 1) <= count ? replacement : match }
       else
         raise ArgumentError, "wrong number of arguments (#{args.size} for 2-3)"
     end
-    
-    i = 0
-    gsub!(pattern) { |match|
-      (i += 1) <= count ? block[match] : match
-    }
   end
 
 end

data/lib/nuggets/string/sub_with_md.rb

@@ -37,18 +37,20 @@ class String
   #
   # Just like #sub, but passes the MatchData object instead of the current
   # match string to the block.
-  def sub_with_md(pattern, replacement = nil, &block)
-    return sub_without_md(pattern, replacement) if replacement
-    dup.sub_with_md!(pattern, &block) || dup
+  def sub_with_md(pattern, replacement = nil)
+    replacement ?
+      sub_without_md(pattern, replacement) :
+      (_dup = dup).sub_with_md!(pattern) { |*a| yield(*a) } || _dup
   end
 
   # call-seq:
   #   str.sub_with_md!(pattern) { |match_data| ... } => str or nil
   #
   # Destructive version of #sub_with_md.
-  def sub_with_md!(pattern, replacement = nil, &block)
-    return sub_without_md!(pattern, replacement) if replacement
-    sub_without_md!(pattern) { |match| block[$~] }
+  def sub_with_md!(pattern, replacement = nil)
+    replacement ?
+      sub_without_md!(pattern, replacement) :
+      sub_without_md!(pattern) { |match| yield $~ }
   end
 
   # call-seq:
@@ -56,18 +58,20 @@ class String
   #
   # Just like #gsub, but passes the MatchData object instead of the current
   # match string to the block.
-  def gsub_with_md(pattern, replacement = nil, &block)
-    return gsub_without_md(pattern, replacement) if replacement
-    dup.gsub_with_md!(pattern, &block) || dup
+  def gsub_with_md(pattern, replacement = nil)
+    replacement ?
+      gsub_without_md(pattern, replacement) :
+      (_dup = dup).gsub_with_md!(pattern) { |*a| yield(*a) } || _dup
   end
 
   # call-seq:
   #   str.gsub_with_md!(pattern) { |match_data| ... } => str or nil
   #
   # Destructive version of #gsub_with_md.
-  def gsub_with_md!(pattern, replacement = nil, &block)
-    return gsub_without_md!(pattern, replacement) if replacement
-    gsub_without_md!(pattern) { |match| block[$~] }
+  def gsub_with_md!(pattern, replacement = nil)
+    replacement ?
+      gsub_without_md!(pattern, replacement) :
+      gsub_without_md!(pattern) { |match| yield $~ }
   end
 
   # call-seq:

data/lib/nuggets/string/word_wrap.rb

@@ -60,7 +60,7 @@ class String
   #
   # Similar to #word_wrap, but assumes a single paragraph.
   def word_wrap_paragraph(line_width = 80)
-    dup.word_wrap_paragraph!(line_width) || dup
+    (_dup = dup).word_wrap_paragraph!(line_width) || _dup
   end
 
   # call-seq:

data/lib/nuggets/{tempfile.rb → tempfile/open.rb}

@@ -29,23 +29,6 @@ require 'tempfile'
 
 class Tempfile
 
-  if RUBY_RELEASE_DATE < '2007-10-05'
-    alias_method :_nuggets_original_make_tmpname, :make_tmpname
-
-    # Enhanced Tempfile#make_tmpname, as of r13631 (Ruby version prior to
-    # 2007-10-05)
-    def make_tmpname(basename, name)
-      case basename
-        when Array
-          prefix, suffix = *basename
-        else
-          prefix, suffix = basename, ''
-      end
-
-      "#{prefix}#{Time.now.strftime('%Y%m%d')}-#{$$}-#{rand(0x100000000).to_s(36)}-#{name}#{suffix}"
-    end
-  end
-
   alias_method :_nuggets_original_open, :open
 
   # If no block is given, this is a synonym for new().

data/lib/nuggets/util/added_methods/init.rb

@@ -1,3 +1,3 @@
 # just a short-cut
-require File.dirname(__FILE__)
+require 'nuggets/util/added_methods'
 Util::AddedMethods.init

data/lib/nuggets/util/added_methods.rb

@@ -70,7 +70,7 @@ module Util
 
     extend self
 
-    HISTFILENAME = '(Readline::HISTORY)'.freeze
+    HISTFILENAME = '(Readline::HISTORY)'.freeze unless const_defined?(:HISTFILENAME)
 
     class AddedMethod
 

data/lib/nuggets/util/content_type.rb

@@ -25,7 +25,10 @@
 ###############################################################################
 #++
 
-require 'rubygems'
+begin
+  require 'rubygems'
+rescue LoadError
+end
 
 begin
   require 'filemagic/ext'
@@ -35,6 +38,16 @@ rescue LoadError
   end
 end
 
+begin
+  require 'nuggets/uri/content_type'
+rescue LoadError
+  module URI
+    def self.content_type(path)  # :nodoc:
+      nil
+    end
+  end
+end
+
 begin
   require 'mime/types'
 rescue LoadError
@@ -47,8 +60,6 @@ rescue LoadError
   end
 end
 
-require File.join(File.dirname(__FILE__), '..', 'uri', 'content_type')
-
 module Util
 
   module ContentType

data/lib/nuggets/util/dotted_decimal.rb

@@ -25,7 +25,7 @@
 ###############################################################################
 #++
 
-require File.join(File.dirname(__FILE__), '..', 'integer', 'to_binary_s')
+require 'nuggets/integer/to_binary_s'
 
 class Integer
 

data/lib/nuggets/util/i18n.rb

@@ -106,7 +106,7 @@ class String
   # Substitutes any diacritics in _str_ with their replacements as per
   # Util::I18n::DIACRITICS.
   def replace_diacritics
-    dup.replace_diacritics! || dup
+    (_dup = dup).replace_diacritics! || _dup
   end
 
   # call-seq:

data/lib/nuggets/version.rb

@@ -3,8 +3,8 @@ module Nuggets
   module Version
 
     MAJOR = 0
-    MINOR = 3
-    TINY  = 6
+    MINOR = 4
+    TINY  = 0
 
     class << self
 

data/lib/nuggets.rb

@@ -24,6 +24,20 @@
 ###############################################################################
 #++
 
+# Load selected +nuggets+.
+#
+# Examples:
+#   # All String nuggets
+#   Nuggets(:string)
+#   Nuggets(String)
+#
+#   # Only 'msub' and 'word_wrap' String nuggets
+#   Nuggets(:string => %w[msub word_wrap])
+#
+#   # Selected String nuggets and all Numeric nuggets
+#   Nuggets(:numeric, :string => %w[msub word_wrap])
+#
+#   # ...you see the pattern ;-)
 def Nuggets(*nuggets)
   loaded_nuggets = []
 
@@ -32,7 +46,7 @@ def Nuggets(*nuggets)
 
     nuggets.each { |nugget|
       begin
-        require path = File.join(base.to_s, nugget.to_s)
+        require path = File.join(base.to_s, nugget.to_s.downcase)
         loaded_nuggets << path
       rescue LoadError
         # if it's a directory, load anything in it
@@ -49,7 +63,7 @@ def Nuggets(*nuggets)
 
     nuggets_by_hierarchy.each { |hierarchy, nuggets|
       nuggets = [nuggets] if nuggets.is_a?(Hash)
-      load_nuggets[File.join(base.to_s, hierarchy.to_s), *nuggets]
+      load_nuggets[File.join(base.to_s, hierarchy.to_s.downcase), *nuggets]
     }
   }
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-nuggets
 version: !ruby/object:Gem::Version 
-  version: 0.3.6.294
+  version: 0.4.0
 platform: ruby
 authors: 
 - Jens Wille
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-10-10 00:00:00 +02:00
+date: 2008-12-05 00:00:00 +01:00
 default_executable: 
 dependencies: []
 
@@ -24,80 +24,81 @@ extra_rdoc_files:
 - ChangeLog
 - README
 files: 
-- lib/nuggets.rb
-- lib/nuggets/integer/to_binary_s.rb
-- lib/nuggets/integer/factorial.rb
-- lib/nuggets/version.rb
-- lib/nuggets/object/metaclass.rb
-- lib/nuggets/object/singleton_class.rb
-- lib/nuggets/object/virtual_class.rb
-- lib/nuggets/object/ghost_class.rb
-- lib/nuggets/object/eigenclass.rb
-- lib/nuggets/object/blank.rb
-- lib/nuggets/object/msend.rb
-- lib/nuggets/object/uniclass.rb
+- lib/nuggets/env/user_home.rb
+- lib/nuggets/env/user_encoding.rb
+- lib/nuggets/numeric/limit.rb
+- lib/nuggets/numeric/to_multiple.rb
+- lib/nuggets/numeric/between.rb
+- lib/nuggets/numeric/duration.rb
+- lib/nuggets/numeric/signum.rb
+- lib/nuggets/array/to_hash.rb
+- lib/nuggets/array/shuffle.rb
+- lib/nuggets/array/format.rb
+- lib/nuggets/array/monotone.rb
+- lib/nuggets/array/only.rb
+- lib/nuggets/array/flatten_once.rb
+- lib/nuggets/array/rand.rb
+- lib/nuggets/array/combination.rb
+- lib/nuggets/array/in_order.rb
+- lib/nuggets/hash/only.rb
+- lib/nuggets/hash/at.rb
+- lib/nuggets/hash/insert.rb
+- lib/nuggets/hash/in_order.rb
 - lib/nuggets/enumerable/agrep.rb
 - lib/nuggets/enumerable/all_any_extended.rb
 - lib/nuggets/enumerable/minmax.rb
+- lib/nuggets/io/agrep.rb
+- lib/nuggets/io/modes.rb
 - lib/nuggets/all.rb
-- lib/nuggets/string/sub_with_md.rb
+- lib/nuggets/uri/content_type.rb
+- lib/nuggets/uri/exist.rb
 - lib/nuggets/string/msub.rb
-- lib/nuggets/string/case.rb
+- lib/nuggets/string/capitalize_first.rb
 - lib/nuggets/string/evaluate.rb
-- lib/nuggets/string/word_wrap.rb
+- lib/nuggets/string/case.rb
+- lib/nuggets/string/sub_with_md.rb
 - lib/nuggets/string/nsub.rb
-- lib/nuggets/string/capitalize_first.rb
-- lib/nuggets/env/user_home.rb
-- lib/nuggets/env/user_encoding.rb
-- lib/nuggets/hash/at.rb
-- lib/nuggets/hash/only.rb
-- lib/nuggets/hash/in_order.rb
-- lib/nuggets/hash/insert.rb
+- lib/nuggets/string/word_wrap.rb
+- lib/nuggets/integer/to_binary_s.rb
+- lib/nuggets/integer/factorial.rb
+- lib/nuggets/object/uniclass.rb
+- lib/nuggets/object/virtual_class.rb
+- lib/nuggets/object/blank.rb
+- lib/nuggets/object/ghost_class.rb
+- lib/nuggets/object/metaclass.rb
+- lib/nuggets/object/singleton_class.rb
+- lib/nuggets/object/eigenclass.rb
+- lib/nuggets/object/msend.rb
+- lib/nuggets/object/boolean.rb
 - lib/nuggets/proc/bind.rb
-- lib/nuggets/array/rand.rb
-- lib/nuggets/array/to_hash.rb
-- lib/nuggets/array/flatten_once.rb
-- lib/nuggets/array/only.rb
-- lib/nuggets/array/in_order.rb
-- lib/nuggets/array/shuffle.rb
-- lib/nuggets/array/monotone.rb
-- lib/nuggets/array/format.rb
-- lib/nuggets/array/combination.rb
-- lib/nuggets/numeric/between.rb
-- lib/nuggets/numeric/duration.rb
-- lib/nuggets/numeric/signum.rb
-- lib/nuggets/numeric/limit.rb
-- lib/nuggets/numeric/to_multiple.rb
-- lib/nuggets/util/added_methods/init.rb
 - lib/nuggets/util/added_methods.rb
-- lib/nuggets/util/ansicolor2css.rb
 - lib/nuggets/util/content_type.rb
 - lib/nuggets/util/dotted_decimal.rb
+- lib/nuggets/util/ansicolor2css.rb
 - lib/nuggets/util/i18n.rb
+- lib/nuggets/util/added_methods/init.rb
+- lib/nuggets/version.rb
+- lib/nuggets/tempfile/open.rb
 - lib/nuggets/file/which.rb
-- lib/nuggets/tempfile.rb
-- lib/nuggets/uri/content_type.rb
-- lib/nuggets/uri/exist.rb
-- lib/nuggets/io/modes.rb
-- lib/nuggets/io/agrep.rb
-- COPYING
+- lib/nuggets.rb
+- Rakefile
 - HEADER
-- README
+- COPYING
 - ChangeLog
-- Rakefile
+- README
 has_rdoc: true
 homepage: http://prometheus.rubyforge.org/ruby-nuggets
 post_install_message: 
 rdoc_options: 
-- --title
-- ruby-nuggets Application documentation
-- --charset
-- UTF-8
 - --main
 - README
-- --all
 - --line-numbers
 - --inline-source
+- --all
+- --title
+- ruby-nuggets Application documentation
+- --charset
+- UTF-8
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -115,7 +116,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: prometheus
-rubygems_version: 1.3.0
+rubygems_version: 1.3.1
 signing_key: 
 specification_version: 2
 summary: Some extensions to the Ruby programming language.