ruby-nuggets 0.4.5 → 0.5.0

data/lib/nuggets/object/boolean_mixin.rb

@@ -0,0 +1,62 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 Object
+    module BooleanMixin
+
+  # 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
+  end
+end

data/lib/nuggets/object/msend.rb

@@ -1,55 +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/msend_mixin'
 
 class Object
-
-  # call-seq:
-  #   object.msend(*messages) => anArray
-  #
-  # Sends _object_ multiple +messages+ and returns an array of the individual
-  # return values.
-  def msend(*messages)
-    hash = messages.last.is_a?(Hash) ? messages.pop : {}
-    (messages + hash.to_a).map { |msg| send *msg.is_a?(Array) ? msg : [msg] }
-  end
-
-end
-
-if $0 == __FILE__
-  o = 'foo bar'
-  p o
-  p o.msend(:length, :reverse)
-
-  o = 42
-  p o
-  p o.msend(:to_s, :* => 2)
-  p o.msend([:to_s, 2], '-@')
-
-  o = Time.now
-  p o
-  p o.msend(:year, :month, :day)
+  include Nuggets::Object::MSendMixin
 end

data/lib/nuggets/object/msend_mixin.rb

@@ -0,0 +1,44 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 Object
+    module MSendMixin
+
+  # call-seq:
+  #   object.msend(*messages) => anArray
+  #
+  # Sends _object_ multiple +messages+ and returns an array of the individual
+  # return values.
+  def msend(*messages)
+    hash = messages.last.is_a?(::Hash) ? messages.pop : {}
+    (messages + hash.to_a).map { |msg| send(*msg.is_a?(::Array) ? msg : [msg]) }
+  end
+
+    end
+  end
+end

data/lib/nuggets/object/silence.rb

@@ -0,0 +1,5 @@
+require 'nuggets/object/silence_mixin'
+
+class Object
+  include Nuggets::Object::SilenceMixin
+end

data/lib/nuggets/object/silence_mixin.rb

@@ -0,0 +1,45 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 Object
+    module SilenceMixin
+
+  # call-seq:
+  #   silence { ... }
+  #
+  # Silence warnings for block execution.
+  def silence
+    verbose, $VERBOSE = $VERBOSE, nil
+    yield
+  ensure
+    $VERBOSE = verbose
+  end
+
+    end
+  end
+end

data/lib/nuggets/object/singleton_class.rb

@@ -1,152 +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/singleton_class_mixin'
 
 class Object
-
-  # call-seq:
-  #   object.singleton_class => aClass
-  #
-  # Returns the singleton (or virtual/eigen/meta) class associated with _object_.
-  def singleton_class
-    class << self; self; end
-  end
-
-  alias_method :virtual_class, :singleton_class
-  alias_method :ghost_class,   :singleton_class
-  alias_method :eigenclass,    :singleton_class
-  alias_method :metaclass,     :singleton_class
-  alias_method :uniclass,      :singleton_class
-
-  # call-seq:
-  #   object.singleton_object => anObject
-  #
-  # Returns the object of which _object_ is the singleton_class.
-  # Raises a TypeError if _object_ is not a singleton class.
-  def singleton_object
-    [true, false, nil].each { |obj|
-      return obj if self.equal?(obj.singleton_class)
-    }
-
-    # raises TypeError if neither class nor module
-    ObjectSpace.each_object(self) { |obj|
-      return obj if self.equal?(obj.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
-    raise TypeError, 'not a singleton class'
-  end
-
-  alias_method :virtual_object, :singleton_object
-  alias_method :ghost_object,   :singleton_object
-  alias_method :eigenobject,    :singleton_object
-  alias_method :metaobject,     :singleton_object
-  alias_method :uniobject,      :singleton_object
-
-  alias_method :singleton_instance, :singleton_object
-
-  # call-seq:
-  #   object.singleton_class? => true or false
-  #
-  # Returns true if _object_ is a singleton_class
-  # (i.e., has a singleton_object), false otherwise.
-  def singleton_class?
-    singleton_object
-    true
-  rescue TypeError
-    false
-  end
-
-  alias_method :virtual_class?, :singleton_class?
-  alias_method :ghost_class?,   :singleton_class?
-  alias_method :eigenclass?,    :singleton_class?
-  alias_method :metaclass?,     :singleton_class?
-  alias_method :uniclass?,      :singleton_class?
-
-end
-
-if $0 == __FILE__
-  o = Object.new
-  p o
-  p o.singleton_class?
-
-  begin
-    p o.singleton_object
-  rescue TypeError => err
-    warn err
-  end
-
-  s = o.singleton_class
-  p s
-  p s.singleton_class?
-  p s.singleton_object
-
-  ###
-
-  o = [1, 2]
-  p o
-
-  s = o.singleton_class
-  p s
-  p s.singleton_class?
-  p s.singleton_object
-
-  ###
-
-  p Class.new.singleton_class?
-  p Class.singleton_class?
-
-  ###
-
-  c = Class.new
-  o = c.new
-  p o
-  p c.singleton_class?
-
-  ###
-
-  p nil.singleton_class
-  p NilClass.singleton_class?
-  p NilClass.singleton_object
-
-  ###
-
-  class A      # :nodoc:
-  end
-  class B < A  # :nodoc:
-  end
-
-  a = A.singleton_class
-  b = B.singleton_class
-
-  p a
-  p a.singleton_object  #=> A
-  p b
-  p b.singleton_object  #=> B
+  include Nuggets::Object::SingletonClassMixin
 end

data/lib/nuggets/object/singleton_class_mixin.rb

@@ -0,0 +1,96 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 Object
+    module SingletonClassMixin
+
+  # call-seq:
+  #   object.singleton_class => aClass
+  #
+  # Returns the singleton (or virtual/eigen/meta) class associated with _object_.
+  def singleton_class
+    class << self; self; end
+  end
+
+  alias_method :virtual_class, :singleton_class
+  alias_method :ghost_class,   :singleton_class
+  alias_method :eigenclass,    :singleton_class
+  alias_method :metaclass,     :singleton_class
+  alias_method :uniclass,      :singleton_class
+
+  # call-seq:
+  #   object.singleton_object => anObject
+  #
+  # Returns the object of which _object_ is the singleton_class.
+  # Raises a TypeError if _object_ is not a singleton class.
+  def singleton_object
+    [true, false, nil].each { |obj|
+      return obj if self.equal?(obj.singleton_class)
+    }
+
+    # raises TypeError if neither class nor module
+    ObjectSpace.each_object(self) { |obj|
+      return obj if self.equal?(obj.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
+    raise TypeError, 'not a singleton class'
+  end
+
+  alias_method :virtual_object, :singleton_object
+  alias_method :ghost_object,   :singleton_object
+  alias_method :eigenobject,    :singleton_object
+  alias_method :metaobject,     :singleton_object
+  alias_method :uniobject,      :singleton_object
+
+  alias_method :singleton_instance, :singleton_object
+
+  # call-seq:
+  #   object.singleton_class? => true or false
+  #
+  # Returns true if _object_ is a singleton_class
+  # (i.e., has a singleton_object), false otherwise.
+  def singleton_class?
+    singleton_object
+    true
+  rescue TypeError
+    false
+  end
+
+  alias_method :virtual_class?, :singleton_class?
+  alias_method :ghost_class?,   :singleton_class?
+  alias_method :eigenclass?,    :singleton_class?
+  alias_method :metaclass?,     :singleton_class?
+  alias_method :uniclass?,      :singleton_class?
+
+    end
+  end
+end

data/lib/nuggets/proc/bind.rb

@@ -1,68 +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/proc/bind_mixin'
 
 class Proc
-
-  # call-seq:
-  #   proc.bind(object) => aMethod
-  #
-  # Straight from Rails' ActiveSupport -- effectively binds _proc_ to +object+.
-  def bind(object)
-    block, time = self, Time.now
-
-    (class << object; self; end).class_eval {
-      method_name = "__bind_#{time.to_i}_#{time.usec}"
-      define_method(method_name, &block)
-
-      method = instance_method(method_name)
-      remove_method(method_name)
-
-      method
-    }.bind(object)
-  end
-
-end
-
-if $0 == __FILE__
-  l = lambda { bla }
-
-  begin
-    l.call
-  rescue NameError => err
-    puts "#{err} (#{err.class})"
-  end
-
-  module Bla  # :nodoc:
-
-    def self.bla
-      puts 'blub'
-    end
-
-  end
-
-  l.bind(Bla).call
+  include Nuggets::Proc::BindMixin
 end

data/lib/nuggets/proc/bind_mixin.rb

@@ -0,0 +1,52 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 Proc
+    module BindMixin
+
+  # call-seq:
+  #   proc.bind(object) => aMethod
+  #
+  # Straight from Rails' ActiveSupport -- effectively binds _proc_ to +object+.
+  def bind(object)
+    block, time = self, ::Time.now
+
+    (class << object; self; end).class_eval {
+      method_name = "__bind_#{time.to_i}_#{time.usec}"
+      define_method(method_name, &block)
+
+      method = instance_method(method_name)
+      remove_method(method_name)
+
+      method
+    }.bind(object)
+  end
+
+    end
+  end
+end

data/lib/nuggets/tempfile/open.rb

@@ -29,26 +29,30 @@ require 'tempfile'
 
 class Tempfile
 
-  alias_method :_nuggets_original_open, :open
-
-  # If no block is given, this is a synonym for new().
-  #
-  # If a block is given, it will be passed tempfile as an argument,
-  # and the tempfile will automatically be closed when the block
-  # terminates.  In this case, open() returns tempfile -- in contrast
-  # to the original implementation, which returns nil.
-  def self.open(*args)
-    tempfile = new(*args)
-
-    if block_given?
-      begin
-        yield tempfile
-      ensure
-        tempfile.close
+  class << self
+
+    alias_method :_nuggets_original_open, :open
+
+    # If no block is given, this is a synonym for new().
+    #
+    # If a block is given, it will be passed tempfile as an argument,
+    # and the tempfile will automatically be closed when the block
+    # terminates.  In this case, open() returns tempfile -- in contrast
+    # to the original implementation, which returns nil.
+    def open(*args)
+      tempfile = new(*args)
+
+      if block_given?
+        begin
+          yield tempfile
+        ensure
+          tempfile.close
+        end
       end
+
+      tempfile
     end
 
-    tempfile
   end
 
 end