ruby-nuggets 0.0.3.159 → 0.0.4.171

data/README

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

data/lib/nuggets/enumerable/minmax.rb

@@ -0,0 +1,117 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 Enumerable
+
+  alias_method :original_max, :max
+  alias_method :original_min, :min
+
+  # call-seq:
+  #   enum.minmax_by(meth, by) => aValue
+  #
+  # Finds the maximum/minimum (or whatever +meth+ is) value in _enum_ according
+  # to +by+ (which may be a symbol/string that is sent to each value, or a proc
+  # that receives each value as parameter).
+  def minmax_by(meth, by)
+    _by = by.is_a?(Proc) ? by : lambda { |i| i.send(by) }
+    send(meth) { |a, b| _by[a] <=> _by[b] }
+  end
+
+  # call-seq:
+  #   enum.max_by(by) => aValue
+  #
+  # Maximum #minmax_by.
+  def max_by(by)
+    minmax_by(:max, by)
+  end
+
+  # call-seq:
+  #   enum.min_by(by) => aValue
+  #
+  # Minimum #minmax_by.
+  def min_by(by)
+    minmax_by(:min, by)
+  end
+
+  # call-seq:
+  #   enum.minmax(meth, what) => anObject
+  #
+  # Finds the #minmax_by according to +what+ and returns that "what".
+  #
+  # Example:
+  #   %w[a bcd ef].max(:length)  #=> 3
+  def minmax(meth, what)
+    #m = minmax_by(meth, what)
+    #what.is_a?(Proc) ? what[m] : m.send(what)
+
+    _what = what.is_a?(Proc) ? what : lambda { |i| i.send(what) }
+    map { |i| _what[i] }.send(meth)
+
+    # Benchmark (:max, :length; enum.size = 20, N = 100_000):
+    #
+    # max_by(:length).length   7.920000   0.890000   8.810000 (  8.991915)
+    # map(:length).max         4.800000   0.600000   5.400000 (  5.418114)
+  end
+
+  # call-seq:
+  #   enum.max(what) => aValue
+  #
+  # Maximum #minmax. If +what+ is omitted, or nil, the original Enumerable#max
+  # is called (available as +original_max+).
+  def max(what = nil, &block)
+    what ? minmax(:max, what) : original_max(&block)
+  end
+
+  # call-seq:
+  #   enum.min(what) => aValue
+  #
+  # Minimum #minmax. If +what+ is omitted, or nil, the original Enumerable#min
+  # is called (available as +original_min+).
+  def min(what = nil, &block)
+    what ? minmax(:min, what) : original_min(&block)
+  end
+
+end
+
+if $0 == __FILE__
+  e = %w[quux quuux quix]
+  p e
+
+  p e.max
+  p e.max_by(:length)
+  p e.max(:length)
+
+  e = [3, 222, 45]
+  p e
+
+  # the last digit counts ;-)
+  l = lambda { |i| i.to_s.split(//).last.to_i }
+
+  p e.max
+  p e.max_by(l)
+  p e.max(l)
+end

data/lib/nuggets/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-nuggets
 version: !ruby/object:Gem::Version 
-  version: 0.0.3.159
+  version: 0.0.4.171
 platform: ruby
 authors: 
 - Jens Wille
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-01-08 00:00:00 +01:00
+date: 2008-01-10 00:00:00 +01:00
 default_executable: 
 dependencies: []
 
@@ -27,6 +27,7 @@ files:
 - lib/nuggets/version.rb
 - lib/nuggets/object/singleton_class.rb
 - lib/nuggets/object/blank.rb
+- lib/nuggets/enumerable/minmax.rb
 - lib/nuggets/all.rb
 - lib/nuggets/string/msub.rb
 - lib/nuggets/string/case.rb
@@ -54,15 +55,15 @@ has_rdoc: true
 homepage: http://prometheus.rubyforge.org/ruby-nuggets
 post_install_message: 
 rdoc_options: 
-- --all
-- --inline-source
 - --charset
 - UTF-8
-- --main
-- README
+- --all
 - --title
 - ruby-nuggets Application documentation
+- --main
+- README
 - --line-numbers
+- --inline-source
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement