deep_hash 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in deep_hash.gemspec
+gemspec

data/README.md

@@ -0,0 +1,30 @@
+deep_hash
+=========
+
+`deep_hash` is a Ruby gem that provides ways to deal with multi-level default hashes.
+
+Usage
+-----
+
+Right now the only functionality is to create such a hash. This is useful if you use multi-dimensional default
+hashes a lot. For example, multi-dimensional tables of counts (defaulting to 0) are often useful.
+
+```ruby
+require "deep_hash"
+h = Hash.deep(0) # is equivalent to
+h = {}
+
+h = Hash.deep(2) # is equivalent to
+h = Hash.new { |k1, v1| k1[v1] = Hash.new { |k2, v2| k2[v2] = {} } }
+
+h = Hash.deep(0) { "foobar" } # is equivalent to
+h = Hash.new { |k, v| k[v] = "foobar" }
+
+h = Hash.deep(1) { 0 } is equivalent to
+h = Hash.new { |k1, v1| k1[v1] = Hash.new { |k2, v2| k2[v2] = 0 } }
+```
+
+Installation
+------------
+
+    gem install deep_hash

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/deep_hash.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "deep_hash/version"
+
+Gem::Specification.new do |s|
+  s.name        = "deep_hash"
+  s.version     = DeepHash::VERSION
+  s.authors     = ["Caleb Spare"]
+  s.email       = ["cespare@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{Utilities for dealing with multi-level hashes}
+  s.description = %q{DeepHash is a collection of utilities for dealing with multi-level hashes.}
+
+  s.rubyforge_project = "deep_hash"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency "scope", "~> 0.2.2"
+end

data/lib/deep_hash/version.rb

@@ -0,0 +1,3 @@
+module DeepHash
+  VERSION = "0.0.1"
+end

data/lib/deep_hash.rb

@@ -0,0 +1,11 @@
+require "deep_hash/version"
+
+class Hash
+  def self.deep(depth, &block)
+    raise "Need non-negative depth" if depth < 0
+    if depth.zero?
+      return block_given? ? Hash.new { |k, v| k[v] = block.call } : {}
+    end
+    Hash.new { |k, v| k[v] = Hash.deep(depth - 1, &block) }
+  end
+end

data/test/deep_hash_test.rb

@@ -0,0 +1,51 @@
+require "scope"
+require "minitest/autorun"
+
+require "deep_hash"
+
+class DeepHashTest < Scope::TestCase
+  def assert_expected_hash(expected, actual)
+    assert expected.is_a? Hash
+    assert actual.is_a? Hash
+    assert_equal expected.keys.sort, actual.keys.sort
+    expected.keys.each do |key|
+      if expected[key].is_a? Hash
+        assert_expected_hash expected[key], actual[key]
+      else
+        assert_equal expected[key], actual[key]
+      end
+    end
+  end
+
+  context "deep hash creation" do
+    context "with no block" do
+      should "create a plain hash with depth 0" do
+        assert_expected_hash({}, Hash.deep(0))
+      end
+
+      should "should create a properly nested hash of the specified depth" do
+        hash = Hash.deep(1)
+        hash[0][1] = 2
+        assert_equal({}, hash[1])
+        assert_expected_hash({ 0 => { 1 => 2 }, 1 => {} }, hash)
+      end
+    end
+
+    context "with a block given" do
+      should "create a normal default-valued hash with depth 0" do
+        hash = Hash.deep(0) { "foobar" }
+        hash[:a] = 3
+        assert_equal "foobar", hash[:b]
+        assert_expected_hash({ :a => 3, :b => "foobar" }, hash)
+      end
+
+      should "properly create a mult-level default hash" do
+        hash = Hash.deep(1) { "foobar" }
+        hash[:a][0] = 5
+        assert_equal "foobar", hash[:a][1]
+        assert_equal "foobar", hash[:b][0]
+        assert_expected_hash({ :a => { 0 => 5, 1 => "foobar" }, :b => { 0 => "foobar" } }, hash)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: deep_hash
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Caleb Spare
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-06-28 00:00:00.000000000 -07:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: scope
+  requirement: &2165618400 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.2.2
+  type: :development
+  prerelease: false
+  version_requirements: *2165618400
+description: DeepHash is a collection of utilities for dealing with multi-level hashes.
+email:
+- cespare@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- deep_hash.gemspec
+- lib/deep_hash.rb
+- lib/deep_hash/version.rb
+- test/deep_hash_test.rb
+has_rdoc: true
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: deep_hash
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Utilities for dealing with multi-level hashes
+test_files:
+- test/deep_hash_test.rb