fail-fast 1.0.0 → 1.1.0

data/History.txt

@@ -1,3 +1,8 @@
+== 1.1.0 2009-07-19
+
+* 1 major enhancement:
+  * Added assert_only_keys
+
 == 1.0.0 2008-11-29
 
 * 1 major enhancement:

data/README.rdoc

@@ -51,7 +51,11 @@ FailFast is a collection of assertion methods intended for lightweight contract
   try { assert_keys(h, :foo, :bar) } # => {:foo=>1, :bar=>2, :baz=>nil}
   try { assert_keys(h, :baz) }       # => "<Assertion Failure>"
   try { assert_keys(h, :buz) }       # => "<Assertion Failure>"
-  
+
+  # Assert that an object is hash-like and has only the given keys
+  h = {:foo => 1, :bar => nil}
+  try { assert_keys(h, :foo, :bar) } # => {:foo => 1, :bar => nil}
+  try { assert_keys(h, :foo) }       # => "<Assertion Failure>"
 
 == REQUIREMENTS:
 

data/lib/fail_fast.rb

@@ -2,7 +2,7 @@ $:.unshift(File.dirname(__FILE__)) unless
   $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
 
 module FailFast
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 
   class AssertionFailureError < Exception
   end
@@ -48,6 +48,18 @@ module FailFast
       hash
     end
 
+    # Assert that +hash+ exists, responds to #[], and has no keys other than
+    # +keys+.  Returns +hash+.
+    def assert_only_keys(hash, *keys)
+      assert_exists(hash)
+      assert(hash.respond_to?(:[]))
+      values = hash.inject([]) { |vals, (k, v)| 
+        assert(keys.include?(k)); vals << hash[k] 
+      }
+      assert(yield(*values)) if block_given?
+      hash
+    end
+
     # Assert that +object+ responds to +messages+.  Returns +object+.
     def assert_respond_to(object, *messages)
       messages.each do |message|

data/spec/fail_fast_spec.rb

@@ -277,6 +277,77 @@ describe FailFast::Assertions, "#assert_keys" do
   end
 end
 
+describe FailFast::Assertions, "#assert_only_keys" do
+
+  include FailFast::Assertions
+
+  def do_assertion(*args, &block)
+    assert_only_keys(*args, &block)
+  end
+
+  def do_success(&block)
+    assert_only_keys({:foo => true}, :foo, &block)
+  end
+
+  def do_failure(&block)
+    assert_only_keys({:foo, :bar}, :foo, &block)
+  end
+
+  it_should_behave_like "any assertion"
+  it_should_behave_like "an assertion taking a block"
+
+  it "should fail if an unspecified key is present" do
+    lambda { assert_only_keys({:bar => true}, :foo) }.
+      should raise_error(FailFast::AssertionFailureError)
+  end
+
+  it "should fail if the given hash is nil" do
+    lambda do
+      assert_only_keys(nil)
+    end.should raise_error(FailFast::AssertionFailureError)
+  end
+
+  it "should fail if given something unlike a hash" do
+    lambda do
+      assert_only_keys(true)
+    end.should raise_error(FailFast::AssertionFailureError)
+  end
+
+  it "should always fail if no keys are given" do
+    lambda do
+      assert_only_keys({:foo => true, :bar => nil})
+    end.should raise_error(FailFast::AssertionFailureError)
+  end
+
+  it "should yield values of keys which are present" do
+    did_yield = false
+    assert_only_keys({:foo => 23}, :foo, :bar) do |x, y|
+      did_yield = true
+      x.should == 23
+      y.should be_nil
+      true
+    end
+    did_yield.should be_true
+  end
+
+  it "should yield nothing if a key is wrong" do
+    begin
+      did_yield = false
+      assert_only_keys({:foo => 23, :baz => 32}, :foo, :bar) do |x, y|
+        did_yield = true
+      end
+    rescue FailFast::AssertionFailureError
+      did_yield.should be_false
+    end
+  end
+
+  it "should return the hash" do
+    @hash = { :buz => 42 }
+    assert_only_keys(@hash, :buz).should equal(@hash)
+  end
+end
+
+
 describe FailFast::Assertions, "#assert_respond_to" do
   include FailFast::Assertions
 

metadata

@@ -1,35 +1,15 @@
 --- !ruby/object:Gem::Specification 
 name: fail-fast
 version: !ruby/object:Gem::Version 
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors: 
 - Avdi Grimm
 autorequire: 
 bindir: bin
-cert_chain: 
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIDKDCCAhCgAwIBAgIBADANBgkqhkiG9w0BAQUFADA6MQ0wCwYDVQQDDARhdmRp
-  MRQwEgYKCZImiZPyLGQBGRYEYXZkaTETMBEGCgmSJomT8ixkARkWA29yZzAeFw0w
-  ODExMjYwMzQwMTBaFw0wOTExMjYwMzQwMTBaMDoxDTALBgNVBAMMBGF2ZGkxFDAS
-  BgoJkiaJk/IsZAEZFgRhdmRpMRMwEQYKCZImiZPyLGQBGRYDb3JnMIIBIjANBgkq
-  hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxp+TCbzj+cyaiE1xAqxO+irHbdNF+9y4
-  rZF3gCs0wfIcqeKDIvlks7FvH0Qj6yiAj8YHUgmuLORat2IBLBmX/G+G0Z2L6MLs
-  bNwx4YpbTW1cwOFVENSWwNjsvY68/I/EpAeRdtiskG/J33TDxi427dyBDSHsrQ8J
-  4oC24EnKwsTOdHwkEaDEmZJQeo5ienR7dalAwIPCIm4tA41kbilLVpMVp0f1hn5o
-  cVFYZgJFOdNnggVO9B/0/doQhxvC4Jdj2XeoOdIkjul1VjCeF+s+i/PhnKk/Y0++
-  /9fBCqzfFHYay5TOtTLDlzc7WoN5NBtKChn1gG0AnD+mJ4EnjvgTIQIDAQABozkw
-  NzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUen5OQUuU+3P6OyVZ
-  NsrtAIO7DQcwDQYJKoZIhvcNAQEFBQADggEBAGwXuO2cpDc9m8iJmmbSjnDhhQYL
-  OssAG5bMy88JnrD+KufXA4BKvLTLkNtTSaNFvL74+FSIK8VwCUpEyn8rsYi3s6N8
-  /f5+5LDg19Jm6dmkRgFGQjF8cW0PheDtlY0Ywo+wdUhD+LFH+2VanZNx2dz6IjSh
-  A0uvcb+roaNG70ESPvoJO4PZFCkrgS2QE9TwnhRLi1DONaGmbMYWSZku4tHFEu+R
-  B/QQd37jgRGtEcplcoMaoCOqAvlIu6QkQt4X3jVhNGqeF2Wgmb1QXEF8cH/hqX4T
-  NNbtubu/GbyYwC2cb3Clh5gMrAYS765Q8U2aySfRySAFaQyPub+h0uVWkIc=
-  -----END CERTIFICATE-----
+cert_chain: []
 
-date: 2008-11-30 00:00:00 -05:00
+date: 2009-07-19 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -40,7 +20,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.1.0
+        version: 1.3.0
     version: 
 - !ruby/object:Gem::Dependency 
   name: hoe
@@ -109,7 +89,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: fail-fast
-rubygems_version: 1.2.0
+rubygems_version: 1.3.1
 signing_key: 
 specification_version: 2
 summary: FailFast is a collection of assertion methods intended for lightweight contract checking.