ruby-nuggets 0.6.9 → 0.7.0

data/lib/nuggets/util/ruby.rb

@@ -109,8 +109,8 @@ module Util
 
     # Returns whether the Ruby interpreter supports process forking.
     def ruby_supports_fork?
-      # MRI >= 1.9.2's respond_to? returns false for methods
-      # that are not implemented.
+      # MRI >= 1.9.2's respond_to? returns false
+      # for methods that are not implemented.
       Process.respond_to?(:fork) &&
       RUBY_ENGINE != 'jruby'     &&
       RUBY_ENGINE != 'macruby'   &&
@@ -124,7 +124,7 @@ module Util
 
     # If the current Ruby interpreter is managed by RVM, returns the
     # directory in which RVM places its working files. Otherwise returns
-    # nil.
+    # +nil+.
     def rvm_path
       return @rvm_path if defined?(@rvm_path)
 
@@ -147,7 +147,7 @@ module Util
     # currently active gemset, e.g. something like this:
     # "ruby-1.9.2-p0@mygemset"
     #
-    # Returns nil otherwise.
+    # Returns +nil+ otherwise.
     def rvm_ruby_string
       return @rvm_ruby_string if defined?(@rvm_ruby_string)
 
@@ -194,7 +194,7 @@ module Util
     # NOTE: The return value may not be the actual correct invocation for the tool.
     # Use command_for_ruby_tool for that.
     #
-    # Returns nil when nothing's found.
+    # Returns +nil+ when nothing's found.
     def locate_ruby_tool(name)
       extensions = ['', CONFIG['EXEEXT']].compact.uniq
 
@@ -213,8 +213,8 @@ module Util
     end
 
     # Returns the correct command string for invoking the +name+ executable
-    # that belongs to the current Ruby interpreter. Returns nil if the command
-    # is not found.
+    # that belongs to the current Ruby interpreter. Returns +nil+ if the
+    # command is not found.
     #
     # If the command executable is a Ruby program, then we need to run it
     # in the correct Ruby interpreter just in case the command doesn't

data/lib/nuggets/version.rb

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

data/spec/nuggets/array/mean_spec.rb

@@ -0,0 +1,127 @@
+require 'nuggets/array/mean'
+
+describe Array, 'when extended by', Nuggets::Array::MeanMixin do
+
+  it { Array.ancestors.should include(Nuggets::Array::MeanMixin) }
+
+  describe 'equalities' do
+
+    %w[arithmetic geometric harmonic].each { |type|
+      method = "#{type}_mean"
+
+      example do
+        val = rand
+        ary = [val] * 10
+
+        ary.send(method).should equal_float(val)
+      end
+
+      example do
+        ary, const = Array.new(10) { rand }, rand
+
+        res1 = ary.map { |i| const * i }.send(method)
+        res2 = ary.send(method)
+
+        res1.should equal_float(const * res2)
+      end
+    }
+
+  end
+
+  describe 'inequalities' do
+
+    before :each do
+      @ary = Array.new(10) { rand }
+    end
+
+    3.times {
+
+      { 0 => 1, 1 => 2, 3 => 23, 0.1 => 0.2, -1 => 0, -3 => -2 }.each { |exponent1, exponent2|
+        example do
+          @ary.generalized_mean(exponent1).should <= @ary.generalized_mean(exponent2)
+        end
+      }
+
+      example do
+        res = %w[quadratic arithmetic geometric harmonic].map { |type| @ary.send("#{type}_mean") }
+        res[0].should >= res[1]; res[1].should >= res[2]; res[2].should >= res[3]
+      end
+
+    }
+
+  end
+
+  describe 'arithmetic mean' do
+
+    example do
+      [].arithmetic_mean.should be_nil
+    end
+
+    example do
+      [1].arithmetic_mean.should == 1.0
+    end
+
+    example do
+      [1, 1, 1].arithmetic_mean.should == 1.0
+    end
+
+    example do
+      [1, 2, 3].arithmetic_mean.should == 2.0
+    end
+
+    example do
+      [3, 2, 1].arithmetic_mean.should == 2.0
+    end
+
+    example do
+      [-3, -2, -1].arithmetic_mean.should == -[3, 2, 1].arithmetic_mean
+    end
+
+    context do
+
+      before :each do
+        @ary = [1, -2, 1, 2, 3, -4, 0, 3, 1, 2, 1, 0, 24]
+        @res = @ary.arithmetic_mean
+      end
+
+      example do
+        @res.should equal_float(2.46153846153846)
+      end
+
+      %w[mean average avg].each { |method|
+        example { @ary.send(method).should == @res }
+      }
+
+    end
+
+    describe '(weighted)' do
+
+      example do
+        [1, 2, 3].arithmetic_mean { |i| 0 }.should be_nil
+      end
+
+      example do
+        [1, 2, 3].arithmetic_mean { |i| 1 / i.to_f }.should equal_float(1.63636363636364)
+      end
+
+      example do
+        w = rand
+        [1, 2, 3].arithmetic_mean { |i| w }.should == 2.0
+      end
+
+      example do
+        [1, 2, 3].arithmetic_mean { |i| i ** 2 }.should equal_float(2.57142857142857)
+      end
+
+    end
+
+  end
+
+  # TODO: other methods
+  # TODO: more examples: http://people.revoledu.com/kardi/tutorial/BasicMath/Average/mean.html
+
+  def equal_float(value, precision = 1.0e-14)
+    be_within(precision).of(value)
+  end
+
+end

data/spec/nuggets/array/median_spec.rb

@@ -0,0 +1,79 @@
+require 'nuggets/array/median'
+
+describe Array, 'when extended by', Nuggets::Array::MedianMixin do
+
+  it { Array.ancestors.should include(Nuggets::Array::MedianMixin) }
+
+  example do
+    [].median.should be_nil
+  end
+
+  example do
+    [1].median.should == 1
+  end
+
+  example do
+    [1, 1, 1].median.should == 1
+  end
+
+  example do
+    [1, 2, 3].median.should == 2
+  end
+
+  example do
+    [3, 2, 1].median.should == 2
+  end
+
+  example do
+    [-3, -2, -1].median.should == -[3, 2, 1].median
+  end
+
+  example do
+    [1, -2, 1, 2, 3, -4, 0, 3, 1, 2, 1, 0, 24].median.should == 1
+  end
+
+  example do
+    [1, 2, 3, 4].median.should == 2.5
+  end
+
+  example do
+    %w[one two three].median.should == 'three'
+  end
+
+  example do
+    %w[three two one].median.should == 'three'
+  end
+
+  [true, 1, :left].each { |prefer|
+    example { [1, 2, 3].median(prefer).should == 2 }
+    example { [1, 2, 3, 4].median(prefer).should == 2 }
+
+    example { %w[one two three].median(prefer).should == 'three' }
+    example { %w[one two three four].median(prefer).should == 'one' }
+  }
+
+  [false, 2, :right].each { |prefer|
+    example { [1, 2, 3].median(prefer).should == 2 }
+    example { [1, 2, 3, 4].median(prefer).should == 3 }
+
+    example { %w[one two three].median(prefer).should == 'three' }
+    example { %w[one two three four].median(prefer).should == 'three' }
+  }
+
+  example do
+    [1, 2, 3, 4].median { |a, b| a * b }.should == 6
+  end
+
+  example do
+    %w[one two three four].median { |a, b| b * a.length }.should == 'threethreethree'
+  end
+
+  example do
+    lambda { %w[one two three four].median }.should raise_error(NoMethodError, %q{undefined method `/' for "onethree":String})
+  end
+
+  example do
+    lambda { [1, 2, 'three'].median }.should raise_error(ArgumentError, 'comparison of Fixnum with String failed')
+  end
+
+end

data/spec/nuggets/array/mode_spec.rb

@@ -0,0 +1,59 @@
+require 'nuggets/array/mode'
+
+describe Array, 'when extended by', Nuggets::Array::ModeMixin do
+
+  it { Array.ancestors.should include(Nuggets::Array::ModeMixin) }
+
+  example do
+    [].mode.should be_nil
+  end
+
+  example do
+    [1].mode.should == 1
+  end
+
+  example do
+    [1, 1, 1].mode.should == 1
+  end
+
+  example do
+    [1, 2, 2, 3].mode.should == 2
+  end
+
+  example do
+    [3, 2, 2, 1].mode.should == 2
+  end
+
+  example do
+    [-3, -2, -2, -1].mode.should == -[3, 2, 2, 1].mode
+  end
+
+  example do
+    [1, -2, 1, 2, 3, -4, 0, 3, 1, 2, 1, 0, 24].mode.should == 1
+  end
+
+  example do
+    [1, 2, 2, 3, 3, 4].modes.should == [2, 3]
+  end
+
+  example do
+    [2, 3].should include([1, 2, 2, 3, 3, 4].mode)
+  end
+
+  example do
+    %w[one two three three].mode.should == 'three'
+  end
+
+  example do
+    %w[three two one three].mode.should == 'three'
+  end
+
+  example do
+    [1, 2, 2, 3, 4].mode { |x| x * 2 }.should == 4
+  end
+
+  example do
+    [1, 2, 3, 4].modes { |x| x / 2 }.should == [1]
+  end
+
+end

data/spec/nuggets/string/evaluate_spec.rb

@@ -11,9 +11,9 @@ describe String, 'when extended by', Nuggets::String::EvaluateMixin do
         example { str.evaluate(binding).should == res }
       }
 
-      example {
+      example do
         lambda { str.evaluate(binding) }.should raise_error(NameError, /`a'/)
-      }
+      end
     }
 
   end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-nuggets
 version: !ruby/object:Gem::Version 
-  hash: 21
+  hash: 3
   prerelease: 
   segments: 
   - 0
-  - 6
-  - 9
-  version: 0.6.9
+  - 7
+  - 0
+  version: 0.7.0
 platform: ruby
 authors: 
 - Jens Wille
@@ -15,8 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-11 00:00:00 +01:00
-default_executable: 
+date: 2011-04-05 00:00:00 Z
 dependencies: []
 
 description: Some extensions to the Ruby programming language.
@@ -26,9 +25,9 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
+- README
 - COPYING
 - ChangeLog
-- README
 files: 
 - lib/nuggets.rb
 - lib/nuggets/integer/map_mixin.rb
@@ -45,24 +44,37 @@ files:
 - lib/nuggets/util/ansicolor2css.rb
 - lib/nuggets/util/added_methods.rb
 - lib/nuggets/array/shuffle.rb
+- lib/nuggets/array/mean.rb
 - lib/nuggets/array/variance_mixin.rb
+- lib/nuggets/array/mode_mixin.rb
+- lib/nuggets/array/median.rb
 - lib/nuggets/array/format.rb
+- lib/nuggets/array/mode.rb
 - lib/nuggets/array/to_hash.rb
 - lib/nuggets/array/rand.rb
+- lib/nuggets/array/median_mixin.rb
 - lib/nuggets/array/runiq.rb
+- lib/nuggets/array/mean_mixin.rb
+- lib/nuggets/array/regression_mixin.rb
 - lib/nuggets/array/monotone.rb
 - lib/nuggets/array/combination.rb
 - lib/nuggets/array/flatten_once.rb
 - lib/nuggets/array/standard_deviation_mixin.rb
+- lib/nuggets/array/histogram_mixin.rb
 - lib/nuggets/array/variance.rb
 - lib/nuggets/array/limit.rb
+- lib/nuggets/array/correlation.rb
 - lib/nuggets/array/standard_deviation.rb
+- lib/nuggets/array/histogram.rb
+- lib/nuggets/array/correlation_mixin.rb
 - lib/nuggets/array/limit_mixin.rb
 - lib/nuggets/array/in_order.rb
 - lib/nuggets/array/runiq_mixin.rb
+- lib/nuggets/array/regression.rb
 - lib/nuggets/array/only.rb
 - lib/nuggets/proc/bind_mixin.rb
 - lib/nuggets/proc/bind.rb
+- lib/nuggets/statistics.rb
 - lib/nuggets/hash/nest_mixin.rb
 - lib/nuggets/hash/insert.rb
 - lib/nuggets/hash/unroll.rb
@@ -119,6 +131,7 @@ files:
 - lib/nuggets/range/quantile.rb
 - lib/nuggets/all.rb
 - lib/nuggets/version.rb
+- lib/nuggets/statistics_mixins.rb
 - lib/nuggets/object/virtual_class.rb
 - lib/nuggets/object/uniclass.rb
 - lib/nuggets/object/blank.rb
@@ -138,11 +151,13 @@ files:
 - ChangeLog
 - Rakefile
 - COPYING
-- .rspec
 - spec/nuggets/integer/map_spec.rb
 - spec/nuggets/integer/length_spec.rb
+- spec/nuggets/array/mode_spec.rb
 - spec/nuggets/array/variance_spec.rb
 - spec/nuggets/array/runiq_spec.rb
+- spec/nuggets/array/median_spec.rb
+- spec/nuggets/array/mean_spec.rb
 - spec/nuggets/array/limit_spec.rb
 - spec/nuggets/array/standard_deviation_spec.rb
 - spec/nuggets/proc/bind_spec.rb
@@ -167,21 +182,20 @@ files:
 - spec/nuggets/object/silence_spec.rb
 - spec/nuggets/object/blank_spec.rb
 - spec/spec_helper.rb
-has_rdoc: true
+- .rspec
 homepage: http://prometheus.rubyforge.org/ruby-nuggets
 licenses: []
 
 post_install_message: 
 rdoc_options: 
-- --charset
-- UTF-8
+- --line-numbers
 - --main
 - README
+- --charset
+- UTF-8
 - --all
-- --line-numbers
 - --title
-- ruby-nuggets Application documentation (v0.6.9)
-- --inline-source
+- ruby-nuggets Application documentation (v0.7.0)
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -205,7 +219,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: prometheus
-rubygems_version: 1.5.2
+rubygems_version: 1.7.1
 signing_key: 
 specification_version: 3
 summary: Some extensions to the Ruby programming language.