rspec 1.0.0 → 1.3.1

data/spec/spec/matchers/raise_exception_spec.rb

@@ -0,0 +1,345 @@
+require 'spec_helper'
+
+describe "should raise_exception" do
+  it "should pass if anything is raised" do
+    lambda {raise}.should raise_exception
+  end
+  
+  it "should fail if nothing is raised" do
+    lambda {
+      lambda {}.should raise_exception
+    }.should fail_with("expected Exception but nothing was raised")
+  end
+end
+
+describe "should raise_error" do
+  it "should pass if anything is raised" do
+    lambda {raise}.should raise_error
+  end
+  
+  it "should fail if nothing is raised" do
+    lambda {
+      lambda {}.should raise_error
+    }.should fail_with("expected Exception but nothing was raised")
+  end
+end
+
+describe "should raise_exception {|e| ... }" do
+  it "passes if there is an exception" do
+    ran = false
+    lambda { non_existent_method }.should raise_exception {|e|
+      ran = true
+    }
+    ran.should be_true
+  end
+
+  it "passes the exception to the block" do
+    exception = nil
+    lambda { non_existent_method }.should raise_exception {|e|
+      exception = e
+    }
+    exception.should be_kind_of(NameError)
+  end
+end
+
+describe "should_not raise_exception" do
+  it "should pass if nothing is raised" do
+    lambda {}.should_not raise_exception
+  end
+  
+  it "should fail if anything is raised" do
+    lambda {
+      lambda {raise}.should_not raise_exception
+    }.should fail_with("expected no Exception, got RuntimeError")
+  end
+end
+
+describe "should raise_exception(message)" do
+  it "should pass if RuntimeError is raised with the right message" do
+    lambda {raise 'blah'}.should raise_exception('blah')
+  end
+  it "should pass if RuntimeError is raised with a matching message" do
+    lambda {raise 'blah'}.should raise_exception(/blah/)
+  end
+  it "should pass if any other exception is raised with the right message" do
+    lambda {raise NameError.new('blah')}.should raise_exception('blah')
+  end
+  it "should fail if RuntimeError exception is raised with the wrong message" do
+    lambda do
+      lambda {raise 'blarg'}.should raise_exception('blah')
+    end.should fail_with("expected Exception with \"blah\", got #<RuntimeError: blarg>")
+  end
+  it "should fail if any other exception is raised with the wrong message" do
+    lambda do
+      lambda {raise NameError.new('blarg')}.should raise_exception('blah')
+    end.should fail_with("expected Exception with \"blah\", got #<NameError: blarg>")
+  end
+end
+
+describe "should_not raise_exception(message)" do
+  it "should pass if RuntimeError exception is raised with the different message" do
+    lambda {raise 'blarg'}.should_not raise_exception('blah')
+  end
+  it "should pass if any other exception is raised with the wrong message" do
+    lambda {raise NameError.new('blarg')}.should_not raise_exception('blah')
+  end
+  it "should fail if RuntimeError is raised with message" do
+    lambda do
+      lambda {raise 'blah'}.should_not raise_exception('blah')
+    end.should fail_with(%Q|expected no Exception with "blah", got #<RuntimeError: blah>|)
+  end
+  it "should fail if any other exception is raised with message" do
+    lambda do
+      lambda {raise NameError.new('blah')}.should_not raise_exception('blah')
+    end.should fail_with(%Q|expected no Exception with "blah", got #<NameError: blah>|)
+  end
+end
+
+describe "should raise_exception(NamedError)" do
+  it "should pass if named exception is raised" do
+    lambda { non_existent_method }.should raise_exception(NameError)
+  end
+  
+  it "should fail if nothing is raised" do
+    lambda {
+      lambda { }.should raise_exception(NameError)
+    }.should fail_with("expected NameError but nothing was raised")
+  end
+  
+  it "should fail if another exception is raised (NameError)" do
+    lambda {
+      lambda { raise }.should raise_exception(NameError)
+    }.should fail_with("expected NameError, got RuntimeError")
+  end
+  
+  it "should fail if another exception is raised (NameError)" do
+    lambda {
+      lambda { load "non/existent/file" }.should raise_exception(NameError)
+    }.should fail_with(/expected NameError, got #<LoadError/)
+  end
+end
+
+describe "should_not raise_exception(NamedError)" do
+  it "should pass if nothing is raised" do
+    lambda { }.should_not raise_exception(NameError)
+  end
+  
+  it "should pass if another exception is raised" do
+    lambda { raise }.should_not raise_exception(NameError)
+  end
+  
+  it "should fail if named exception is raised" do
+    lambda {
+      lambda { 1 + 'b' }.should_not raise_exception(TypeError)
+    }.should fail_with(/expected no TypeError, got #<TypeError: String can't be/)
+  end  
+end
+
+describe "should raise_exception(NamedError, exception_message) with String" do
+  it "should pass if named exception is raised with same message" do
+    lambda { raise "example message" }.should raise_exception(RuntimeError, "example message")
+  end
+  
+  it "should fail if nothing is raised" do
+    lambda {
+      lambda {}.should raise_exception(RuntimeError, "example message")
+    }.should fail_with("expected RuntimeError with \"example message\" but nothing was raised")
+  end
+  
+  it "should fail if incorrect exception is raised" do
+    lambda {
+      lambda { raise }.should raise_exception(NameError, "example message")
+    }.should fail_with("expected NameError with \"example message\", got RuntimeError")
+  end
+  
+  it "should fail if correct exception is raised with incorrect message" do
+    lambda {
+      lambda { raise RuntimeError.new("not the example message") }.should raise_exception(RuntimeError, "example message")
+    }.should fail_with(/expected RuntimeError with \"example message\", got #<RuntimeError: not the example message/)
+  end
+end
+
+describe "should raise_exception(NamedError, exception_message) { |err| ... }" do
+  it "should yield exception if named exception is raised with same message" do
+    ran = false
+
+    lambda {
+      raise "example message"
+    }.should raise_exception(RuntimeError, "example message") { |err|
+      ran = true
+      err.class.should == RuntimeError
+      err.message.should == "example message"
+    }
+
+    ran.should == true
+  end
+
+  it "yielded block should be able to fail on it's own right" do
+    ran, passed = false, false
+
+    lambda {
+      lambda {
+        raise "example message"
+      }.should raise_exception(RuntimeError, "example message") { |err|
+        ran = true
+        5.should == 4
+        passed = true
+      }
+    }.should fail_with(/expected: 4/m)
+
+    ran.should == true
+    passed.should == false
+  end
+
+  it "should NOT yield exception if no exception was thrown" do
+    ran = false
+
+    lambda {
+      lambda {}.should raise_exception(RuntimeError, "example message") { |err|
+        ran = true
+      }
+    }.should fail_with("expected RuntimeError with \"example message\" but nothing was raised")
+
+    ran.should == false
+  end
+
+  it "should not yield exception if exception class is not matched" do
+    ran = false
+
+    lambda {
+      lambda {
+        raise "example message"
+      }.should raise_exception(SyntaxError, "example message") { |err|
+        ran = true
+      }
+    }.should fail_with("expected SyntaxError with \"example message\", got #<RuntimeError: example message>")
+
+    ran.should == false
+  end
+
+  it "should NOT yield exception if exception message is not matched" do
+    ran = false
+
+    lambda {
+      lambda {
+        raise "example message"
+      }.should raise_exception(RuntimeError, "different message") { |err|
+        ran = true
+      }
+    }.should fail_with("expected RuntimeError with \"different message\", got #<RuntimeError: example message>")
+
+    ran.should == false
+  end
+end
+
+describe "should_not raise_exception(NamedError, exception_message) { |err| ... }" do
+  it "should pass if nothing is raised" do
+    ran = false
+
+    lambda {}.should_not raise_exception(RuntimeError, "example message") { |err|
+      ran = true
+    }
+
+    ran.should == false
+  end
+
+  it "should pass if a different exception is raised" do
+    ran = false
+
+    lambda { raise }.should_not raise_exception(NameError, "example message") { |err|
+      ran = true
+    }
+
+    ran.should == false
+  end
+
+  it "should pass if same exception is raised with different message" do
+    ran = false
+
+    lambda {
+      raise RuntimeError.new("not the example message")
+    }.should_not raise_exception(RuntimeError, "example message") { |err|
+      ran = true
+    }
+
+    ran.should == false
+  end
+
+  it "should fail if named exception is raised with same message" do
+    ran = false
+
+    lambda {
+      lambda {
+        raise "example message"
+      }.should_not raise_exception(RuntimeError, "example message") { |err|
+        ran = true
+      }
+    }.should fail_with("expected no RuntimeError with \"example message\", got #<RuntimeError: example message>")
+
+    ran.should == false
+  end
+end
+
+describe "should_not raise_exception(NamedError, exception_message) with String" do
+  it "should pass if nothing is raised" do
+    lambda {}.should_not raise_exception(RuntimeError, "example message")
+  end
+  
+  it "should pass if a different exception is raised" do
+    lambda { raise }.should_not raise_exception(NameError, "example message")
+  end
+  
+  it "should pass if same exception is raised with different message" do
+    lambda { raise RuntimeError.new("not the example message") }.should_not raise_exception(RuntimeError, "example message")
+  end
+  
+  it "should fail if named exception is raised with same message" do
+    lambda {
+      lambda { raise "example message" }.should_not raise_exception(RuntimeError, "example message")
+    }.should fail_with("expected no RuntimeError with \"example message\", got #<RuntimeError: example message>")
+  end
+end
+
+describe "should raise_exception(NamedError, exception_message) with Regexp" do
+  it "should pass if named exception is raised with matching message" do
+    lambda { raise "example message" }.should raise_exception(RuntimeError, /ample mess/)
+  end
+  
+  it "should fail if nothing is raised" do
+    lambda {
+      lambda {}.should raise_exception(RuntimeError, /ample mess/)
+    }.should fail_with("expected RuntimeError with message matching /ample mess/ but nothing was raised")
+  end
+  
+  it "should fail if incorrect exception is raised" do
+    lambda {
+      lambda { raise }.should raise_exception(NameError, /ample mess/)
+    }.should fail_with("expected NameError with message matching /ample mess/, got RuntimeError")
+  end
+  
+  it "should fail if correct exception is raised with incorrect message" do
+    lambda {
+      lambda { raise RuntimeError.new("not the example message") }.should raise_exception(RuntimeError, /less than ample mess/)
+    }.should fail_with("expected RuntimeError with message matching /less than ample mess/, got #<RuntimeError: not the example message>")
+  end
+end
+
+describe "should_not raise_exception(NamedError, exception_message) with Regexp" do
+  it "should pass if nothing is raised" do
+    lambda {}.should_not raise_exception(RuntimeError, /ample mess/)
+  end
+  
+  it "should pass if a different exception is raised" do
+    lambda { raise }.should_not raise_exception(NameError, /ample mess/)
+  end
+  
+  it "should pass if same exception is raised with non-matching message" do
+    lambda { raise RuntimeError.new("non matching message") }.should_not raise_exception(RuntimeError, /ample mess/)
+  end
+  
+  it "should fail if named exception is raised with matching message" do
+    lambda {
+      lambda { raise "example message" }.should_not raise_exception(RuntimeError, /ample mess/)
+    }.should fail_with("expected no RuntimeError with message matching /ample mess/, got #<RuntimeError: example message>")
+  end
+end

data/spec/spec/matchers/respond_to_spec.rb

@@ -1,54 +1,116 @@
-require File.dirname(__FILE__) + '/../../spec_helper.rb'
+require 'spec_helper'
 
 describe "should respond_to(:sym)" do
   
-  it "should pass if target responds to :sym" do
+  it "passes if target responds to :sym" do
     Object.new.should respond_to(:methods)
   end
   
-  it "should fail target does not respond to :sym" do
+  it "fails if target does not respond to :sym" do
     lambda {
-      Object.new.should respond_to(:some_method)
-    }.should fail_with("expected target to respond to :some_method")
+      "this string".should respond_to(:some_method)
+    }.should fail_with(%q|expected "this string" to respond to :some_method|)
   end
   
 end
 
+describe "should respond_to(:sym).with(1).argument" do
+  it "passes if target responds to :sym with 1 arg" do
+    obj = Object.new
+    def obj.foo(arg); end
+    obj.should respond_to(:foo).with(1).argument
+  end
+  
+  it "fails if target does not respond to :sym" do
+    obj = Object.new
+    lambda {
+      obj.should respond_to(:some_method).with(1).argument
+    }.should fail_with(/expected .* to respond to :some_method/)
+  end
+  
+  it "fails if :sym expects 0 args" do
+    obj = Object.new
+    def obj.foo; end
+    lambda {
+      obj.should respond_to(:foo).with(1).argument
+    }.should fail_with(/expected #<Object.*> to respond to :foo with 1 argument/)
+  end
+  
+  it "fails if :sym expects 2 args" do
+    obj = Object.new
+    def obj.foo(arg, arg2); end
+    lambda {
+      obj.should respond_to(:foo).with(1).argument
+    }.should fail_with(/expected #<Object.*> to respond to :foo with 1 argument/)
+  end
+end
+
 describe "should respond_to(message1, message2)" do
   
-  it "should pass if target responds to both messages" do
+  it "passes if target responds to both messages" do
     Object.new.should respond_to('methods', 'inspect')
   end
   
-  it "should fail target does not respond to first message" do
+  it "fails if target does not respond to first message" do
     lambda {
       Object.new.should respond_to('method_one', 'inspect')
-    }.should fail_with('expected target to respond to "method_one"')
+    }.should fail_with(/expected #<Object:.*> to respond to "method_one"/)
   end
   
-  it "should fail target does not respond to second message" do
+  it "fails if target does not respond to second message" do
     lambda {
       Object.new.should respond_to('inspect', 'method_one')
-    }.should fail_with('expected target to respond to "method_one"')
+    }.should fail_with(/expected #<Object:.*> to respond to "method_one"/)
   end
   
-  it "should fail target does not respond to either message" do
+  it "fails if target does not respond to either message" do
     lambda {
       Object.new.should respond_to('method_one', 'method_two')
-    }.should fail_with('expected target to respond to "method_one", "method_two"')
+    }.should fail_with(/expected #<Object:.*> to respond to "method_one", "method_two"/)
+  end
+end
+
+describe "should respond_to(:sym).with(2).arguments" do
+  it "passes if target responds to :sym with 2 args" do
+    obj = Object.new
+    def obj.foo(a1, a2); end
+    obj.should respond_to(:foo).with(2).arguments
+  end
+  
+  it "fails if target does not respond to :sym" do
+    obj = Object.new
+    lambda {
+      obj.should respond_to(:some_method).with(2).arguments
+    }.should fail_with(/expected .* to respond to :some_method/)
+  end
+  
+  it "fails if :sym expects 0 args" do
+    obj = Object.new
+    def obj.foo; end
+    lambda {
+      obj.should respond_to(:foo).with(2).arguments
+    }.should fail_with(/expected #<Object.*> to respond to :foo with 2 arguments/)
+  end
+  
+  it "fails if :sym expects 2 args" do
+    obj = Object.new
+    def obj.foo(arg); end
+    lambda {
+      obj.should respond_to(:foo).with(2).arguments
+    }.should fail_with(/expected #<Object.*> to respond to :foo with 2 arguments/)
   end
 end
 
 describe "should_not respond_to(:sym)" do
   
-  it "should pass if target does not respond to :sym" do
+  it "passes if target does not respond to :sym" do
     Object.new.should_not respond_to(:some_method)
   end
   
-  it "should fail target responds to :sym" do
+  it "fails if target responds to :sym" do
     lambda {
       Object.new.should_not respond_to(:methods)
-    }.should fail_with("expected target not to respond to :methods")
+    }.should fail_with(/expected #<Object:.*> not to respond to :methods/)
   end
   
-end
+end

data/spec/spec/matchers/satisfy_spec.rb

@@ -1,4 +1,4 @@
-require File.dirname(__FILE__) + '/../../spec_helper.rb'
+require 'spec_helper'
 
 describe "should satisfy { block }" do
   it "should pass if block returns true" do

data/spec/spec/matchers/simple_matcher_spec.rb

@@ -0,0 +1,100 @@
+require 'spec_helper'
+
+module Spec
+  module Matchers
+    describe SimpleMatcher do
+      before { Spec.stub(:deprecate) }
+
+      it "is deprecated" do
+        Spec.should_receive(:deprecate)
+        simple_matcher("foo") {}
+      end
+
+      it "should pass match arg to block" do
+        actual = nil
+        matcher = simple_matcher("message") do |given| actual = given end
+        matcher.matches?("foo")
+        actual.should == "foo"
+      end
+      
+      it "should provide a stock failure message" do
+        matcher = simple_matcher("thing") do end
+        matcher.matches?("other")
+        matcher.failure_message.should =~ /expected \"thing\" but got \"other\"/
+      end
+      
+      it "should provide a stock negative failure message" do
+        matcher = simple_matcher("thing") do end
+        matcher.matches?("other")
+        matcher.negative_failure_message.should =~ /expected not to get \"thing\", but got \"other\"/
+      end
+      
+      it "should provide the given description" do
+        matcher = simple_matcher("thing") do end
+        matcher.description.should =="thing"
+      end
+      
+      it "should fail if a wrapped 'should' fails" do
+        matcher = simple_matcher("should fail") do
+          2.should == 3
+        end
+        lambda do
+          matcher.matches?("anything").should be_true
+        end.should fail_with(/expected: 3/)
+      end
+    
+      describe "with arity of 2" do
+        it "should provide the matcher so you can access its messages" do
+          provided_matcher = nil
+          matcher = simple_matcher("thing") do |given, matcher|
+            provided_matcher = matcher
+          end
+          matcher.matches?("anything")
+          provided_matcher.should equal(matcher)
+        end
+        
+        it "should support a custom failure message" do
+          matcher = simple_matcher("thing") do |given, matcher|
+            matcher.failure_message = "custom message"
+          end
+          matcher.matches?("other")
+          matcher.failure_message.should == "custom message"
+        end
+
+        it "should complain when asked for a failure message if you don't give it a description or a message" do
+          matcher = simple_matcher do |given, matcher| end
+          matcher.matches?("other")
+          matcher.failure_message.should =~ /No description provided/
+        end
+
+        it "should support a custom negative failure message" do
+          matcher = simple_matcher("thing") do |given, matcher|
+            matcher.negative_failure_message = "custom message"
+          end
+          matcher.matches?("other")
+          matcher.negative_failure_message.should == "custom message"
+        end
+        
+        it "should complain when asked for a negative failure message if you don't give it a description or a message" do
+          matcher = simple_matcher do |given, matcher| end
+          matcher.matches?("other")
+          matcher.negative_failure_message.should =~ /No description provided/
+        end
+
+        it "should support a custom description" do
+          matcher = simple_matcher("thing") do |given, matcher|
+            matcher.description = "custom message"
+          end
+          matcher.matches?("description")
+          matcher.description.should == "custom message"
+        end
+
+        it "should tell you no description was provided when it doesn't receive one" do
+          matcher = simple_matcher do end
+          matcher.description.should =~ /No description provided/
+        end
+      end
+      
+    end
+  end
+end