webget-hash_rolldown 1.1.3

data/lib/hash_rolldown.rb

@@ -0,0 +1,53 @@
+# = HashRolldown
+#
+# Author:: Joel Parker Henderson, joelparkerhenderson@gmail.com
+# Copyright:: Copyright (c) 2007-2009 Joel Parker Henderson
+# License:: CreativeCommons License, Non-commercial Share Alike
+# License:: LGPL, GNU Lesser General Public License
+#
+# HashRolldown aggregates value for a hash of hashes,
+# for example to help calculate subtotals grouped by key.
+#
+# Example:
+#   h=Hash.new
+#   h['a']=Hash.new
+#   h['b']=Hash.new
+#   h['c']=Hash.new
+#   h['a']['x']=1
+#   h['a']['y']=2
+#   h['a']['z']=3
+#   h['b']['x']=4
+#   h['b']['y']=5
+#   h['b']['z']=6
+#   h['c']['x']=7
+#   h['c']['y']=8
+#   h['c']['z']=9
+#   h.rolldown => {"x"=>[1,4,7],"y"=>[2,5,8],"z"=>[3,6,9]}
+#
+#
+# = Calculating subtotals
+#
+# The rolldown method is especially useful for calculating subtotals by key.
+#
+# Example:
+#   r=h.rolldown  
+#   r['x'].sum => 12
+#   r['y'].sum => 15
+#   r['z'].sum => 18
+#
+##
+
+module HashRolldown
+
+  def rolldown
+    a=self.class.new
+    keys.each{|k1|
+     self[k1].keys.each{|k2|
+      a[k2]=[] if (a[k2]==nil or a[k2]=={})
+      a[k2]<<self[k1][k2]
+     }
+    }
+    a
+  end
+  
+end

data/test/unit/hash_rolldown_test.rb

@@ -0,0 +1,32 @@
+require 'test/unit'
+require 'hash_rolldown'
+
+class HashRolldownTest < Test::Unit::TestCase
+
+ def test_rolldown
+  h=Hash.new
+  h['a']=Hash.new
+  h['b']=Hash.new
+  h['c']=Hash.new
+  h['a']['x']='m'
+  h['a']['y']='n'
+  h['a']['z']='o'
+  h['b']['x']='p'
+  h['b']['y']='q'
+  h['b']['z']='r'
+  h['c']['x']='s'
+  h['c']['y']='t'
+  h['c']['z']='u'
+  r=h.rolldown
+  assert_equal(['x','y','z'], r.keys.sort)
+  assert_equal(['m','p','s'], r['x'].sort)
+  assert_equal(['n','q','t'], r['y'].sort)
+  assert_equal(['o','r','u'], r['z'].sort)
+ end
+    
+end
+
+
+class Hash
+ include HashRolldown
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification 
+name: webget-hash_rolldown
+version: !ruby/object:Gem::Version 
+  version: 1.1.3
+platform: ruby
+authors: 
+- WebGet
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-02-05 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: 
+email: webget@webget.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/hash_rolldown.rb
+has_rdoc: true
+homepage: http://webget.com/
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: "hash_roldown: a method to aggregate hash values by key, e.g. to calculate subtotals"
+test_files: 
+- test/unit/hash_rolldown_test.rb