ruby-nuggets 0.5.8 → 0.6.0

data/README

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

data/lib/nuggets/array/limit.rb

@@ -0,0 +1,5 @@
+require 'nuggets/array/limit_mixin'
+
+class Array
+  include Nuggets::Array::LimitMixin
+end

data/lib/nuggets/array/limit_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 Array
+    module LimitMixin
+
+  # call-seq:
+  #   array.limit(min, max) => new_array
+  #
+  # Returns a new array of all distinct values in _array_ limited to +min+
+  # and +max+ (cf. Numeric#limit).
+  def limit(min, max)
+    map { |item| item.between(min, max) }.uniq
+  end
+
+  alias_method :between, :limit
+
+    end
+  end
+end

data/lib/nuggets/array/standard_deviation.rb

@@ -0,0 +1,5 @@
+require 'nuggets/array/standard_deviation_mixin'
+
+class Array
+  include Nuggets::Array::StandardDeviationMixin
+end

data/lib/nuggets/array/standard_deviation_mixin.rb

@@ -0,0 +1,54 @@
+#--
+###############################################################################
+#                                                                             #
+# 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/>.              #
+#                                                                             #
+###############################################################################
+#++
+
+require 'nuggets/array/variance_mixin'
+
+module Nuggets
+  class Array
+    module StandardDeviationMixin
+
+  def self.included(base)
+    base.send :include, Nuggets::Array::VarianceMixin
+  end
+
+  # call-seq:
+  #   array.standard_deviation => aFloat
+  #
+  # Calculates the standard deviation of the items contained in _array_.
+  def standard_deviation
+    begin
+      Math.sqrt(block_given? ? variance { |*a| yield(*a) } : variance)
+    rescue Errno::EDOM
+      0.0
+    end
+  end
+
+  alias_method :std, :standard_deviation
+
+    end
+  end
+end

data/lib/nuggets/array/variance.rb

@@ -0,0 +1,5 @@
+require 'nuggets/array/variance_mixin'
+
+class Array
+  include Nuggets::Array::VarianceMixin
+end

data/lib/nuggets/array/variance_mixin.rb

@@ -0,0 +1,58 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 Array
+    module VarianceMixin
+
+  # call-seq:
+  #   array.variance => aFloat
+  #
+  # Calculates the variance of the items in _array_.
+  #
+  # Based on <http://warrenseen.com/blog/2006/03/13/how-to-calculate-standard-deviation/>.
+  def variance
+    s, mean = 0.0, 0.0
+
+    return s if empty?
+
+    each_with_index { |x, n|
+      x = yield x if block_given?
+
+      delta = x - mean
+      mean += delta / (n + 1)
+      s += delta * (x - mean)
+    }
+
+    s / size
+  end
+
+  alias_method :var, :variance
+
+    end
+  end
+end

data/lib/nuggets/hash/unroll_mixin.rb

@@ -34,7 +34,7 @@ module Nuggets
   #   hash.unroll(*value_keys, :sort => ...) => anArray
   #   hash.unroll(*value_keys) { |value_hash| ... } => anArray
   #
-  # "Unrolls" a nested hash, so that each path through +hash+ results in a
+  # "Unrolls" a nested hash, so that each path through _hash_ results in a
   # row that is, e.g., suitable for use with CSV.
   #
   # Note that from the final hash ("value hash") only the values are used,

data/lib/nuggets/util/content_type.rb

@@ -78,8 +78,9 @@ module Util
     # NOTE: This is really only useful with the filemagic and mime-types gems
     # installed.
     def of(path)
-      File.content_type(path) || URI.content_type(path) ||
-        ((t = MIME::Types.of(path)).empty? ? nil : t.first.content_type)
+      File.content_type(path) || URI.content_type(path) || (
+        t = MIME::Types.of(path).first and t.content_type
+      )
     end
 
   end

data/lib/nuggets/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-nuggets
 version: !ruby/object:Gem::Version 
-  version: 0.5.8
+  version: 0.6.0
 platform: ruby
 authors: 
 - Jens Wille
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-07-27 00:00:00 +02:00
+date: 2009-07-31 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
@@ -36,13 +36,19 @@ files:
 - lib/nuggets/numeric/duration.rb
 - lib/nuggets/numeric/signum.rb
 - lib/nuggets/array/to_hash.rb
+- lib/nuggets/array/variance.rb
 - lib/nuggets/array/shuffle.rb
+- lib/nuggets/array/variance_mixin.rb
+- lib/nuggets/array/standard_deviation_mixin.rb
+- lib/nuggets/array/limit.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/standard_deviation.rb
 - lib/nuggets/array/rand.rb
 - lib/nuggets/array/combination.rb
+- lib/nuggets/array/limit_mixin.rb
 - lib/nuggets/array/in_order.rb
 - lib/nuggets/hash/unroll_mixin.rb
 - lib/nuggets/hash/only.rb