deep_fetch 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+*.gem

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Tomasz Pewiński
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,33 @@
+# DeepFetch
+
+Easily fetch values from nested ruby hashes.
+
+## Installation
+
+    $ gem install deep_fetch
+
+## Usage
+
+``` ruby
+require 'deep_fetch'
+
+big_hash = {
+  :foo => {
+    :bar => [ 'a', 'b', 'c' ],
+    :baz => :boo
+  }
+}
+
+big_hash.deep_fetch(:foo, :baz) # :boo
+big_hash.deep_fetch(:foo, :boo) # raises KeyError
+big_hash.deep_fetch(:foo, :boo) { "not found" } # "not found"
+big_hash.deep_fetch(:foo, :bar, 1) # also fetch nested array
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

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

data/deep_fetch.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'deep_fetch/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "deep_fetch"
+  gem.version       = DeepFetch::VERSION
+  gem.authors       = ["Tomasz Pewiński"]
+  gem.email         = ["pewniak747@gmail.com"]
+  gem.description   = %q{easily fetch values from nested ruby hashes}
+  gem.summary   = %q{easily fetch values from nested ruby hashes}
+  gem.homepage      = "https://github.com/pewniak747/deep_fetch"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+end

data/lib/deep_fetch.rb

@@ -0,0 +1,6 @@
+require "deep_fetch/version"
+require "deep_fetch/core_ext"
+
+module DeepFetch
+  # Your code goes here...
+end

data/lib/deep_fetch/core_ext.rb

@@ -0,0 +1,14 @@
+class Hash
+  def deep_fetch *args, &block
+    return self if args.size == 0
+
+    value = fetch(args.shift, &block)
+    if value.kind_of?(Hash)
+      value.deep_fetch(*args, &block)
+    elsif value.kind_of?(Array) && args.size > 0
+      value = value[args.shift]
+      value.deep_fetch(*args, &block)
+    else value
+    end
+  end
+end

data/lib/deep_fetch/version.rb

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

data/spec/deep_fetch_spec.rb

@@ -0,0 +1,53 @@
+require 'minitest/spec'
+require 'minitest/autorun'
+
+require_relative '../lib/deep_fetch'
+
+describe Hash do
+  describe "deep_fetch" do
+    it "must_equal return value from hash" do
+      {:foo => :bar}.deep_fetch(:foo).must_equal :bar
+    end
+
+    it "must_equal return value from block if key not found" do
+      {:foo => :bar}.deep_fetch(:baz) { :boo } .must_equal :boo
+    end
+
+    it "must_equal rise KeyError if no block and key not found" do
+      lambda do
+        {:foo => :bar}.deep_fetch(:baz).must_equal
+      end.must_raise(KeyError)
+    end
+
+    it "must_equal fetch from deep hash" do
+      {:foo => {:bar => :baz}}.deep_fetch(:foo, :bar).must_equal :baz
+    end
+
+    it "must_equal return value from block if key not found in deep hash" do
+      {:foo => {:bar => :baz}}.deep_fetch(:foo, :baz) { :boo } .must_equal :boo
+    end
+
+    it "must_equal raise KeyError if key not found in deep hash and no block" do
+      lambda do
+        {:foo => {:bar => :baz}}.deep_fetch(:foo, :baz)
+      end.must_raise(KeyError)
+    end
+
+    it "must_equal return values from arrays in deep hash" do
+      {:foo => [nil, {:bar => :baz}]}.deep_fetch(:foo, 1, :bar).must_equal :baz
+    end
+
+    it "must_equal fetch hash from deep hash" do
+      {:foo => {:bar => :baz}}.deep_fetch(:foo).must_equal({:bar => :baz})
+    end
+
+    it "must_equal fetch array from deep hash" do
+      {:foo => {:bar => [:baz]}}.deep_fetch(:foo, :bar).must_equal [:baz]
+    end
+
+    it "must_equal not evaluate a default block when fetching from deep hash" do
+      bomb = ->() { raise "BOOM" }
+      {:foo => {:bar => :baz}}.deep_fetch(:foo, :bar, &bomb).must_equal :baz
+    end
+  end
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: deep_fetch
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Tomasz Pewiński
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-15 00:00:00.000000000 Z
+dependencies: []
+description: easily fetch values from nested ruby hashes
+email:
+- pewniak747@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- LICENSE.txt
+- README.md
+- Rakefile
+- deep_fetch.gemspec
+- lib/deep_fetch.rb
+- lib/deep_fetch/core_ext.rb
+- lib/deep_fetch/version.rb
+- spec/deep_fetch_spec.rb
+homepage: https://github.com/pewniak747/deep_fetch
+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: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: easily fetch values from nested ruby hashes
+test_files:
+- spec/deep_fetch_spec.rb
+has_rdoc: