ruby-nuggets 0.8.6 → 0.8.7

data/README

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

data/lib/nuggets/array/mean_mixin.rb

@@ -4,7 +4,7 @@
 # A component of ruby-nuggets, some extensions to the Ruby programming        #
 # language.                                                                   #
 #                                                                             #
-# Copyright (C) 2007-2011 Jens Wille                                          #
+# Copyright (C) 2007-2012 Jens Wille                                          #
 #                                                                             #
 # Authors:                                                                    #
 #     Jens Wille <jens.wille@uni-koeln.de>                                    #
@@ -134,6 +134,51 @@ module Nuggets
 
   alias_method :geomean, :geometric_mean
 
+  # call-seq:
+  #   array.report_mean => anArray
+  #   array.report_mean(method[, precision]) => anArray
+  #
+  # Expects _array_ to be an array of arrays ("rows") of numeric values;
+  # the first "row" may consist of strings (labels) instead. Returns an
+  # array of strings with the mean (according to +method+, default #mean)
+  # of each "column", prepended with the label, if present, and appended
+  # with the standard deviation, if available; all values are subject to
+  # +precision+.
+  #
+  # Examples:
+  #
+  #   [[9.4, 34.75], [9.46, 34.68], [9.51, 34.61]].report_mean
+  #   #=> ["9.4567 +/- 0.0450", "34.6800 +/- 0.0572"]
+  #
+  #   [[9.4, 34.75], [9.46, 34.68], [9.51, 34.61]].report_mean(:harmonic)
+  #   #=> ["9.4565 +/- 0.0450", "34.6799 +/- 0.0572"]
+  #
+  #   [["a", "b"], [9.4, 34.75], [9.46, 34.68], [9.51, 34.61]].report_mean(nil, 2)
+  #   #=> ["a  9.46 +/- 0.04", "b  34.68 +/- 0.06"]
+  #
+  #   CSV.read('csv', headers: true, converters: :numeric).to_a.report_mean
+  #   #=> ["a    9.4567 +/- 0.0450", "b    34.6800 +/- 0.0572"]
+  def report_mean(method = nil, precision = 4)
+    met, sep = [method ||= :mean, 'mean'], ['', '_']
+    lab, std = first.first.is_a?(::String), respond_to?(:std)
+
+    fmt = ["%-#{precision}s", "%.#{precision}f", "+/- %.#{precision}f"]
+
+    until respond_to?(method) || sep.empty?
+      method = met.join(sep.shift)
+    end
+
+    transpose.map! { |x|
+      i, a = [], []
+
+      i << 0 and a << x.shift if lab
+      i << 1 and a << x.send(method)
+      i << 2 and a << x.std if std
+
+      fmt.values_at(*i).join(' ') % a
+    }
+  end
+
     end
   end
 end

data/lib/nuggets/util/cli.rb

@@ -120,8 +120,12 @@ module Util
       ::HighLine.new(stdin, stdout).ask(question, &block)
     end
 
-    def warn(msg)
-      stderr.puts(msg)
+    def puts(*msg)
+      stdout.puts(*msg)
+    end
+
+    def warn(*msg)
+      stderr.puts(*msg)
     end
 
     def quit(msg = nil, include_usage = msg != false)
@@ -138,6 +142,11 @@ module Util
       exit(status)
     end
 
+    def shut(msg = nil, status = 0)
+      puts(msg) if msg
+      exit(status)
+    end
+
     def exit(status = 0)
       ::Kernel.exit(status)
     end
@@ -157,11 +166,13 @@ module Util
       end
     end
 
-    def load_config(file = options[:config] || defaults[:config])
+    def load_config(file = options[:config] || default = defaults[:config])
+      return unless file
+
       if ::File.readable?(file)
         @config = ::YAML.load_file(file)
-      elsif file != defaults[:config]
-        quit "No such file: #{file}"
+      else
+        quit "No such file: #{file}" unless default
       end
     end
 
@@ -205,11 +216,11 @@ module Util
 
     def generic_opts(opts)
       opts.on('-h', '--help', 'Print this help message and exit') {
-        abort opts.to_s
+        shut opts
       }
 
       opts.on('--version', 'Print program version and exit') {
-        abort "#{progname} v#{version}"
+        shut "#{progname} v#{version}"
       }
     end
 

data/lib/nuggets/util/i18n.rb

@@ -96,6 +96,17 @@ module Util
       'ÿ' => 'y'   # LATIN SMALL LETTER Y WITH DIAERESIS
     }
 
+    def self.args_for_map_diacritics
+      @gsub_for_map_diacritics ||= begin
+        map = ::Hash.new { |h, k| h[k] = [] }
+
+        DIACRITICS.each { |a| a.each { |i| map[i].concat(a) } }
+        map.each { |k, v| v.uniq!; map[k] = "(#{::Regexp.union(*v).source})" }
+
+        [::Regexp.union(*map.keys.sort_by { |k| -k.length }), map.method(:[])]
+      end
+    end
+
   end
 
 end
@@ -116,8 +127,10 @@ class String
   #
   # Destructive version of #replace_diacritics.
   def replace_diacritics!
-    gsub!(/#{::Regexp.union(*::Util::I18n::DIACRITICS.keys)}/) { |m|
-      s = ::Util::I18n::DIACRITICS[m]
+    diacritics = ::Util::I18n::DIACRITICS
+
+    gsub!(/#{::Regexp.union(*diacritics.keys)}/) { |m|
+      s = diacritics[m]
 
       # Try to adjust case:
       #   'Äh' => 'AEh' => 'Aeh'
@@ -133,6 +146,15 @@ class String
     }
   end
 
+  def map_diacritics
+    (_dup = dup).map_diacritics! || _dup
+  end
+
+  def map_diacritics!
+    re, block = ::Util::I18n.args_for_map_diacritics
+    gsub!(re, &block)
+  end
+
 end
 
 if $0 == __FILE__

data/lib/nuggets/version.rb

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

data/spec/nuggets/array/mean_spec.rb

@@ -120,4 +120,53 @@ describe Array, 'when extended by', Nuggets::Array::MeanMixin do
   # TODO: other methods
   # TODO: more examples: http://people.revoledu.com/kardi/tutorial/BasicMath/Average/mean.html
 
+  describe 'report mean' do
+
+    before :each do
+      @ary = [[9.4, 34.75], [9.46, 34.68], [9.51, 34.61]]
+    end
+
+    describe 'w/o stddev' do
+
+      before :each do
+        class << @ary; undef_method :std; end if @ary.respond_to?(:std)
+      end
+
+      example do
+        @ary.report_mean.should == ['9.4567', '34.6800']
+      end
+
+      example do
+        @ary.report_mean(:harmonic).should == ['9.4565', '34.6799']
+      end
+
+      example do
+        @ary.unshift(%w[a b]).report_mean(nil, 2).should == ['a  9.46', 'b  34.68']
+      end
+
+    end
+
+    describe 'w/ stddev' do
+
+      before :each do
+        require 'nuggets/array/standard_deviation_mixin'
+        @ary.extend(Nuggets::Array::StandardDeviationMixin)
+      end
+
+      example do
+        @ary.report_mean.should == ['9.4567 +/- 0.0450', '34.6800 +/- 0.0572']
+      end
+
+      example do
+        @ary.report_mean(:harmonic).should == ['9.4565 +/- 0.0450', '34.6799 +/- 0.0572']
+      end
+
+      example do
+        @ary.unshift(%w[a b]).report_mean(nil, 2).should == ['a  9.46 +/- 0.04', 'b  34.68 +/- 0.06']
+      end
+
+    end
+
+  end
+
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-nuggets
 version: !ruby/object:Gem::Version 
-  hash: 51
+  hash: 49
   prerelease: 
   segments: 
   - 0
   - 8
-  - 6
-  version: 0.8.6
+  - 7
+  version: 0.8.7
 platform: ruby
 authors: 
 - Jens Wille
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-04-20 00:00:00 Z
+date: 2012-04-27 00:00:00 Z
 dependencies: []
 
 description: Some extensions to the Ruby programming language.
@@ -206,14 +206,14 @@ licenses: []
 
 post_install_message: 
 rdoc_options: 
+- --line-numbers
 - --main
 - README
+- --all
 - --charset
 - UTF-8
 - --title
-- ruby-nuggets Application documentation (v0.8.6)
-- --all
-- --line-numbers
+- ruby-nuggets Application documentation (v0.8.7)
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement