ruby-nuggets 0.5.5 → 0.5.6

data/README

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

data/lib/nuggets/hash/nest.rb

@@ -0,0 +1,5 @@
+require 'nuggets/hash/nest_mixin'
+
+class Hash
+  extend Nuggets::Hash::NestMixin
+end

data/lib/nuggets/hash/nest_mixin.rb

@@ -0,0 +1,65 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 Hash
+    module NestMixin
+
+  # call-seq:
+  #   Hash.nest(depth = 0) => aHash
+  #   Hash.nest(depth = 0, value) => aHash
+  #   Hash.nest(depth = 0) { |key| ... } => aHash
+  #
+  # Creates a nested hash, +depth+ levels deep. The final hash will receive a
+  # default value of +value+ or, if +value+ is not given but a block is given,
+  # the result of the key yielded to that block, or, otherwise, the hash's
+  # original default value, typically +nil+.
+  #
+  # NOTE: If you set the default value for one of the nested hashes explicitly,
+  # all of the effects described here disappear for that hash because that also
+  # means that the default proc will be cleared.
+  #
+  # Example:
+  #
+  #   hash = Hash.nest(3)
+  #   hash[:foo][:bar][:a] = { :x => 1, :y => 2 }
+  #   hash[:foo][:bar][:b] = { :x => 0, :y => 3 }
+  #   hash
+  #   #=> {:foo=>{:bar=>{:b=>{:y=>3, :x=>0}, :a=>{:y=>2, :x=>1}}}}
+  def nest(depth = 0, value = default = Object.new, &block)
+    new { |hash, key|
+      hash[key] = if depth.zero?
+        default ? block ? block[key] : hash.default : value
+      else
+        default ? nest(depth - 1, &block) : nest(depth - 1, value)
+      end
+    }
+  end
+
+    end
+  end
+end

data/lib/nuggets/hash/unroll.rb

@@ -0,0 +1,5 @@
+require 'nuggets/hash/unroll_mixin'
+
+class Hash
+  include Nuggets::Hash::UnrollMixin
+end

data/lib/nuggets/hash/unroll_mixin.rb

@@ -0,0 +1,70 @@
+#--
+###############################################################################
+#                                                                             #
+# 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 Hash
+    module UnrollMixin
+
+  # call-seq:
+  #   hash.unroll(*value_keys) => anArray
+  #   hash.unroll(*value_keys) { |key, value| ... } => anArray
+  #
+  # "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 only the values are used, namely, if +value_keys+ are given, the
+  # values at those keys are returned. If a block is given, all hashes are
+  # passed through that block for sorting before being put into the result
+  # array.
+  #
+  # Examples:
+  #
+  #   { :foo => { :bar => { :a => { :x => 1, :y => 2 }, :b => { :x => 0, :y => 3 } } } }.unroll
+  #   #=> [[:foo, :bar, :b, 3, 0], [:foo, :bar, :a, 2, 1]]
+  #
+  #   { :foo => { :bar => { :a => { :x => 1, :y => 2 }, :b => { :x => 0, :y => 3 } } } }.unroll(&:to_s)
+  #   #=> [[:foo, :bar, :a, 1, 2], [:foo, :bar, :b, 0, 3]]
+  def unroll(*value_keys, &sort_block)
+    rows = []
+
+    if values.first.is_a?(self.class)  # if any is, then all are
+      (sort_block ? sort_by(&sort_block) : self).each { |key, value|
+        value.unroll(*value_keys, &sort_block).each { |row| rows << [key, *row] }
+      }
+    else
+      rows << if value_keys.empty?
+        sort_block ? sort_by(&sort_block).map(&:last) : values
+      else
+        values_at(*value_keys)
+      end
+    end
+
+    rows
+  end
+
+    end
+  end
+end

data/lib/nuggets/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: ruby-nuggets
 version: !ruby/object:Gem::Version 
-  version: 0.5.5
+  version: 0.5.6
 platform: ruby
 authors: 
 - Jens Wille
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-04-23 00:00:00 +02:00
+date: 2009-07-24 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
@@ -44,9 +44,13 @@ files:
 - lib/nuggets/array/rand.rb
 - lib/nuggets/array/combination.rb
 - lib/nuggets/array/in_order.rb
+- lib/nuggets/hash/unroll_mixin.rb
 - lib/nuggets/hash/only.rb
 - lib/nuggets/hash/at.rb
 - lib/nuggets/hash/insert.rb
+- lib/nuggets/hash/nest_mixin.rb
+- lib/nuggets/hash/unroll.rb
+- lib/nuggets/hash/nest.rb
 - lib/nuggets/hash/in_order.rb
 - lib/nuggets/enumerable/agrep.rb
 - lib/nuggets/enumerable/all_any_extended.rb
@@ -110,15 +114,15 @@ licenses: []
 
 post_install_message: 
 rdoc_options: 
+- --main
+- README
+- --line-numbers
 - --inline-source
 - --title
 - ruby-nuggets Application documentation
+- --all
 - --charset
 - UTF-8
-- --main
-- README
-- --line-numbers
-- --all
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -136,7 +140,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: prometheus
-rubygems_version: 1.3.2
+rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
 summary: Some extensions to the Ruby programming language.