grab 0.0.4 → 0.1.0

data/README.md

@@ -3,8 +3,8 @@
 Grab provides an clean way to fetch multiple values from a hash. Instead of:
 
     def initialize(params)
-      foo = params.fetch(:foo)
-      bar = params.fetch(:bar)
+      foo = params[:foo]
+      bar = params[:bar]
     end
 
 you can write:
@@ -13,10 +13,10 @@ you can write:
       foo, bar = params.grab(:foo, :bar)
     end
 
-or if some of your params are optional:
+or if want to use Array#fetch instead of Array#[]:
 
     def initialize(params)
-      foo, bar = params.values(:foo, :bar)
+      foo, bar = params.grab!(:foo, :bar)
     end
 
 ## Installation

data/lib/grab.rb

@@ -2,19 +2,14 @@ require "grab/version"
 
 module Grab
   def grab(*keys)
-    keys.map { |k| self.fetch(k) }
+    keys.map { |k| self[k] }
   end
 
-  def values(*args)
-    args.map { |k| self[k] }
+  def grab!(*keys)
+    keys.map { |k| self.fetch(k) }
   end
 end
 
 class Hash
   include Grab
-
-  def values(*args)
-    args = keys if args.empty?
-    super
-  end
 end

data/lib/grab/version.rb

@@ -1,3 +1,3 @@
 module Grab
-  VERSION = "0.0.4"
+  VERSION = "0.1.0"
 end

data/spec/grab_spec.rb

@@ -1,35 +1,35 @@
 require 'grab'
 
-describe "#grab" do
+describe "#grab!" do
   let(:h) { {a: 1, b: 2} }
 
   it "fetches a single value from the hash" do
-    h.grab(:a).should == [1]
+    h.grab!(:a).should == [1]
   end
 
   it "fetches multiple values from the hash" do
-    h.grab(:a, :b).should == [1,2]
+    h.grab!(:a, :b).should == [1,2]
   end
 
   it "raises a KeyError for nonexistent keys" do
     expect do
-      h.grab(:a, :b, :c)
+      h.grab!(:a, :b, :c)
     end.to raise_error(KeyError, "key not found: :c")
   end
 end
 
-describe "#values" do
+describe "#grab" do
   let(:h) { {a: 1, b: 2} }
 
-  it "retains the original behaviour of Hash#values" do
-    h.values.should == [1,2]
+  it "requests a single value from the hash" do
+    h.grab(:a).should == [1]
   end
 
-  it "returns multiple values from the hash" do
-    h.values(:a, :b).should == [1,2]
+  it "requests multiple values from the hash" do
+    h.grab(:a, :b).should == [1,2]
   end
 
   it "returns nil for nonexistent keys" do
-    h.values(:a, :b, :c).should == [1,2,nil]
+    h.grab(:a, :b, :c).should == [1,2,nil]
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: grab
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.1.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-08 00:00:00.000000000 Z
+date: 2012-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec