rspec 0.7.5.1 → 0.8.0

data/spec/spec/matchers/description_generation_spec.rb

@@ -0,0 +1,147 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+context "Matchers should be able to generate a description" do
+  setup do
+    @desc = nil
+    @callback = lambda { |desc| @desc = desc }
+    Spec::Matchers.description_generated(&@callback)
+  end
+  
+  specify "should == expected" do
+    "this".should == "this"
+    @desc.should == "should == \"this\""
+  end
+  
+  specify "should_not == expected" do
+    "this".should_not == "that"
+    @desc.should == "should not == \"that\""
+  end
+  
+  specify "should be empty (arbitrary predicate)" do
+    [].should be_empty
+    @desc.should == "should be empty"
+  end
+  
+  specify "should not be empty (arbitrary predicate)" do
+    [1].should_not be_empty
+    @desc.should == "should not be empty"
+  end
+  
+  specify "should be true" do
+    true.should be_true
+    @desc.should == "should be true"
+  end
+  
+  specify "should be false" do
+    false.should be_false
+    @desc.should == "should be false"
+  end
+  
+  specify "should be nil" do
+    nil.should be_nil
+    @desc.should == "should be nil"
+  end
+  
+  specify "should be > n" do
+    5.should be > 3
+    @desc.should == "should be > 3"
+  end
+  
+  specify "should be close" do
+    5.0.should be_close(5.0, 0.5)
+    @desc.should == "should be close to 5.0 (+- 0.5)"
+  end
+  
+  specify "should equal" do
+    expected = "expected"
+    expected.should equal(expected)
+    @desc.should == "should equal \"expected\""
+  end
+  
+  specify "should_not equal" do
+    5.should_not equal(37)
+    @desc.should == "should not equal 37"
+  end
+  
+  specify "should eql" do
+    "string".should eql("string")
+    @desc.should == "should eql \"string\""
+  end
+  
+  specify "should not eql" do
+    "a".should_not eql(:a)
+    @desc.should == "should not eql :a"
+  end
+  
+  specify "should have_key" do
+    {:a => "a"}.should have_key(:a)
+    @desc.should == "should have key :a"
+  end
+  
+  specify "should have n items" do
+    team.should have(3).players
+    @desc.should == "should have 3 players"
+  end
+  
+  specify "should have at least n items" do
+    team.should have_at_least(2).players
+    @desc.should == "should have at least 2 players"
+  end
+  
+  specify "should have at most n items" do
+    team.should have_at_most(4).players
+    @desc.should == "should have at most 4 players"
+  end
+  
+  specify "should include" do
+    [1,2,3].should include(3)
+    @desc.should == "should include 3"
+  end
+  
+  specify "should match" do
+    "this string".should match(/this string/)
+    @desc.should == "should match /this string/"
+  end
+  
+  specify "should raise_error" do
+    lambda { raise }.should raise_error
+    @desc.should == "should raise Exception"
+  end
+  
+  specify "should raise_error with type" do
+    lambda { raise }.should raise_error(RuntimeError)
+    @desc.should == "should raise RuntimeError"
+  end
+  
+  specify "should raise_error with type and message" do
+    lambda { raise "there was an error" }.should raise_error(RuntimeError, "there was an error")
+    @desc.should == "should raise RuntimeError with \"there was an error\""
+  end
+  
+  specify "should respond_to" do
+    [].should respond_to(:insert)
+    @desc.should == "should respond to #insert"
+  end
+  
+  specify "should throw symbol" do
+    lambda { throw :what_a_mess }.should throw_symbol
+    @desc.should == "should throw a Symbol"
+  end
+  
+  specify "should throw symbol (with named symbol)" do
+    lambda { throw :what_a_mess }.should throw_symbol(:what_a_mess)
+    @desc.should == "should throw :what_a_mess"
+  end
+  
+  def team
+    Class.new do
+      def players
+        [1,2,3]
+      end
+    end.new
+  end
+  
+  teardown do
+    Spec::Matchers.unregister_callback(:description_generated, @callback)
+  end
+end

data/spec/spec/matchers/eql_spec.rb

@@ -0,0 +1,41 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+context "should eql(expected)" do
+  
+  specify "should pass if target.eql?(expected)" do
+    1.should eql(1)
+  end
+  
+  specify "should fail unless target.eql?(expected)" do
+    lambda {
+      1.should eql("1")
+    }.should fail
+  end
+  
+  specify "should provide message, expected and actual on failure" do
+    matcher = eql("1")
+    matcher.matches?(1)
+    matcher.failure_message.should == ["expected \"1\", got 1 (using .eql?)", "1", 1]
+  end
+  
+end
+
+context "should_not eql(expected)" do
+  
+  specify "should pass unless target.eql?(expected)" do
+    1.should_not eql("1")
+  end
+  
+  specify "should fail if target.eql?(expected)" do
+    lambda {
+      1.should_not eql(1)
+    }.should fail
+  end
+  
+  specify "should provide message, expected and actual on failure" do
+    matcher = eql(1)
+    matcher.matches?(1)
+    matcher.negative_failure_message.should == ["expected 1 not to equal 1 (using .eql?)", 1, 1]
+  end
+  
+end

data/spec/spec/matchers/equal_spec.rb

@@ -0,0 +1,41 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+context "should equal(expected)" do
+  
+  specify "should pass if target.equal?(expected)" do
+    1.should equal(1)
+  end
+  
+  specify "should fail unless target.equal?(expected)" do
+    lambda {
+      "1".should equal("1")
+    }.should fail
+  end
+  
+  specify "should provide message, expected and actual on failure" do
+    matcher = equal("1")
+    matcher.matches?("1")
+    matcher.failure_message.should == ["expected \"1\", got \"1\" (using .equal?)", "1", "1"]
+  end
+  
+end
+
+context "should_not equal(expected)" do
+  
+  specify "should pass unless target.equal?(expected)" do
+    "1".should_not equal("1")
+  end
+  
+  specify "should fail if target.equal?(expected)" do
+    lambda {
+      1.should_not equal(1)
+    }.should fail
+  end
+  
+  specify "should provide message, expected and actual on failure" do
+    matcher = equal(1)
+    matcher.matches?(1)
+    matcher.negative_failure_message.should == ["expected 1 not to equal 1 (using .equal?)", 1, 1]
+  end
+  
+end

data/spec/spec/matchers/handler_spec.rb

@@ -0,0 +1,75 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+module ExampleExpectations
+  
+  class ArbitraryMatcher
+    def initialize(*args,&block)
+      if args.last.is_a?Hash
+        @expected = args.last[:expected]
+      end
+      if block_given?
+        @expected = block.call
+      end
+      @block = block
+    end
+    
+    def matches?(target)
+      @target = target
+      return @expected == target
+    end
+    
+    def with(new_value)
+      @expected = new_value
+      self
+    end
+    
+    def failure_message
+      "expected #{@expected}, got #{@target}"
+    end
+    
+    def negative_failure_message
+      "expected not #{@expected}, got #{@target}"
+    end
+  end
+  
+  class PositiveOnlyMatcher < ArbitraryMatcher
+    undef negative_failure_message
+  end
+  
+  def arbitrary_matcher(*args, &block)
+    ArbitraryMatcher.new(*args, &block)
+  end
+  
+  def positive_only_matcher(*args, &block)
+    PositiveOnlyMatcher.new(*args, &block)
+  end
+  
+end
+
+context "ExpectationMatcherHandler" do
+  include ExampleExpectations
+  
+  specify "should handle submitted args" do
+    5.should arbitrary_matcher(:expected => 5)
+    5.should arbitrary_matcher(:expected => "wrong").with(5)
+    lambda { 5.should arbitrary_matcher(:expected => 4) }.should fail_with("expected 4, got 5")
+    lambda { 5.should arbitrary_matcher(:expected => 5).with(4) }.should fail_with("expected 4, got 5")
+    5.should_not arbitrary_matcher(:expected => 4)
+    5.should_not arbitrary_matcher(:expected => 5).with(4)
+    lambda { 5.should_not arbitrary_matcher(:expected => 5) }.should fail_with("expected not 5, got 5")
+    lambda { 5.should_not arbitrary_matcher(:expected => 4).with(5) }.should fail_with("expected not 5, got 5")
+  end
+
+  specify "should handle the submitted block" do
+    5.should arbitrary_matcher { 5 }
+    5.should arbitrary_matcher(:expected => 4) { 5 }
+    5.should arbitrary_matcher(:expected => 4).with(5) { 3 }
+  end
+  
+  specify "should explain when matcher does not support should_not" do
+    lambda {
+      5.should_not positive_only_matcher(:expected => 5)
+    }.should fail_with(/Matcher does not support should_not.\n/)
+  end
+
+end

data/spec/spec/matchers/has_spec.rb

@@ -0,0 +1,37 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+context "should have_sym(*args)" do
+  specify "should pass if #has_sym?(*args) returns true" do
+    {:a => "A"}.should have_key(:a)
+  end
+
+  specify "should fail if #has_sym?(*args) returns false" do
+    lambda {
+      {:b => "B"}.should have_key(:a)
+    }.should fail_with("expected #has_key?(:a) to return true, got false")
+  end
+
+  specify "should fail if target does not respond to #has_sym?" do
+    lambda {
+      Object.new.should have_key(:a)
+    }.should raise_error(NoMethodError)
+  end
+end
+
+context "should_not have_sym(*args)" do
+  specify "should pass if #has_sym?(*args) returns false" do
+    {:a => "A"}.should_not have_key(:b)
+  end
+
+  specify "should fail if #has_sym?(*args) returns true" do
+    lambda {
+      {:a => "A"}.should_not have_key(:a)
+    }.should fail_with("expected #has_key?(:a) to return false, got true")
+  end
+
+  specify "should fail if target does not respond to #has_sym?" do
+    lambda {
+      Object.new.should have_key(:a)
+    }.should raise_error(NoMethodError)
+  end
+end

data/spec/spec/matchers/have_spec.rb

@@ -0,0 +1,259 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+module HaveSpecHelper
+  def create_collection_owner_with(n)
+    owner = Spec::Expectations::Helper::CollectionOwner.new
+    (1..n).each do |n|
+      owner.add_to_collection_with_length_method(n)
+      owner.add_to_collection_with_size_method(n)
+    end
+    owner
+  end
+end
+
+context "should have(n).items" do
+  include HaveSpecHelper
+
+  specify "should pass if target has a collection of items with n members" do
+    owner = create_collection_owner_with(3)
+    owner.should have(3).items_in_collection_with_length_method
+    owner.should have(3).items_in_collection_with_size_method
+  end
+
+  specify "should convert :no to 0" do
+    owner = create_collection_owner_with(0)
+    owner.should have(:no).items_in_collection_with_length_method
+    owner.should have(:no).items_in_collection_with_size_method
+  end
+
+  specify "should fail if target has a collection of items with < n members" do
+    owner = create_collection_owner_with(3)
+    lambda {
+      owner.should have(4).items_in_collection_with_length_method
+    }.should fail_with("expected 4 items_in_collection_with_length_method, got 3")
+    lambda {
+      owner.should have(4).items_in_collection_with_size_method
+    }.should fail_with("expected 4 items_in_collection_with_size_method, got 3")
+  end
+  
+  specify "should fail if target has a collection of items with > n members" do
+    owner = create_collection_owner_with(3)
+    lambda {
+      owner.should have(2).items_in_collection_with_length_method
+    }.should fail_with("expected 2 items_in_collection_with_length_method, got 3")
+    lambda {
+      owner.should have(2).items_in_collection_with_size_method
+    }.should fail_with("expected 2 items_in_collection_with_size_method, got 3")
+  end
+end
+
+context "should_not have(n).items" do
+  include HaveSpecHelper
+
+  specify "should pass if target has a collection of items with < n members" do
+    owner = create_collection_owner_with(3)
+    owner.should_not have(4).items_in_collection_with_length_method
+    owner.should_not have(4).items_in_collection_with_size_method
+  end
+  
+  specify "should pass if target has a collection of items with > n members" do
+    owner = create_collection_owner_with(3)
+    owner.should_not have(2).items_in_collection_with_length_method
+    owner.should_not have(2).items_in_collection_with_size_method
+  end
+
+  specify "should fail if target has a collection of items with n members" do
+    owner = create_collection_owner_with(3)
+    lambda {
+      owner.should_not have(3).items_in_collection_with_length_method
+    }.should fail_with("expected target not to have 3 items_in_collection_with_length_method, got 3")
+    lambda {
+      owner.should_not have(3).items_in_collection_with_size_method
+      }.should fail_with("expected target not to have 3 items_in_collection_with_size_method, got 3")
+  end
+end
+
+context "should have_exactly(n).items" do
+  include HaveSpecHelper
+
+  specify "should pass if target has a collection of items with n members" do
+    owner = create_collection_owner_with(3)
+    owner.should have_exactly(3).items_in_collection_with_length_method
+    owner.should have_exactly(3).items_in_collection_with_size_method
+  end
+
+  specify "should convert :no to 0" do
+    owner = create_collection_owner_with(0)
+    owner.should have_exactly(:no).items_in_collection_with_length_method
+    owner.should have_exactly(:no).items_in_collection_with_size_method
+  end
+
+  specify "should fail if target has a collection of items with < n members" do
+    owner = create_collection_owner_with(3)
+    lambda {
+      owner.should have_exactly(4).items_in_collection_with_length_method
+    }.should fail_with("expected 4 items_in_collection_with_length_method, got 3")
+    lambda {
+      owner.should have_exactly(4).items_in_collection_with_size_method
+    }.should fail_with("expected 4 items_in_collection_with_size_method, got 3")
+  end
+  
+  specify "should fail if target has a collection of items with > n members" do
+    owner = create_collection_owner_with(3)
+    lambda {
+      owner.should have_exactly(2).items_in_collection_with_length_method
+    }.should fail_with("expected 2 items_in_collection_with_length_method, got 3")
+    lambda {
+      owner.should have_exactly(2).items_in_collection_with_size_method
+    }.should fail_with("expected 2 items_in_collection_with_size_method, got 3")
+  end
+end
+
+context "should have_at_least(n).items" do
+  include HaveSpecHelper
+
+  specify "should pass if target has a collection of items with n members" do
+    owner = create_collection_owner_with(3)
+    owner.should have_at_least(3).items_in_collection_with_length_method
+    owner.should have_at_least(3).items_in_collection_with_size_method
+  end
+  
+  specify "should pass if target has a collection of items with > n members" do
+    owner = create_collection_owner_with(3)
+    owner.should have_at_least(2).items_in_collection_with_length_method
+    owner.should have_at_least(2).items_in_collection_with_size_method
+  end
+
+  specify "should fail if target has a collection of items with < n members" do
+    owner = create_collection_owner_with(3)
+    lambda {
+      owner.should have_at_least(4).items_in_collection_with_length_method
+    }.should fail_with("expected at least 4 items_in_collection_with_length_method, got 3")
+    lambda {
+      owner.should have_at_least(4).items_in_collection_with_size_method
+    }.should fail_with("expected at least 4 items_in_collection_with_size_method, got 3")
+  end
+  
+  specify "should provide educational negative failure messages" do
+    #given
+    owner = create_collection_owner_with(3)
+    length_matcher = have_at_least(3).items_in_collection_with_length_method
+    size_matcher = have_at_least(3).items_in_collection_with_size_method
+    
+    #when
+    length_matcher.matches?(owner)
+    size_matcher.matches?(owner)
+    
+    #then
+    length_matcher.negative_failure_message.should == <<-EOF
+Isn't life confusing enough?
+Instead of having to figure out the meaning of this:
+  should_not have_at_least(3).items_in_collection_with_length_method
+We recommend that you use this instead:
+  should have_at_most(2).items_in_collection_with_length_method
+EOF
+
+    size_matcher.negative_failure_message.should == <<-EOF
+Isn't life confusing enough?
+Instead of having to figure out the meaning of this:
+  should_not have_at_least(3).items_in_collection_with_size_method
+We recommend that you use this instead:
+  should have_at_most(2).items_in_collection_with_size_method
+EOF
+  end
+end
+
+context "should have_at_most(n).items" do
+  include HaveSpecHelper
+
+  specify "should pass if target has a collection of items with n members" do
+    owner = create_collection_owner_with(3)
+    owner.should have_at_most(3).items_in_collection_with_length_method
+    owner.should have_at_most(3).items_in_collection_with_size_method
+  end
+
+  specify "should fail if target has a collection of items with > n members" do
+    owner = create_collection_owner_with(3)
+    lambda {
+      owner.should have_at_most(2).items_in_collection_with_length_method
+    }.should fail_with("expected at most 2 items_in_collection_with_length_method, got 3")
+    lambda {
+      owner.should have_at_most(2).items_in_collection_with_size_method
+    }.should fail_with("expected at most 2 items_in_collection_with_size_method, got 3")
+  end
+  
+  specify "should pass if target has a collection of items with < n members" do
+    owner = create_collection_owner_with(3)
+    owner.should have_at_most(4).items_in_collection_with_length_method
+    owner.should have_at_most(4).items_in_collection_with_size_method
+  end
+
+  specify "should provide educational negative failure messages" do
+    #given
+    owner = create_collection_owner_with(3)
+    length_matcher = have_at_most(3).items_in_collection_with_length_method
+    size_matcher = have_at_most(3).items_in_collection_with_size_method
+    
+    #when
+    length_matcher.matches?(owner)
+    size_matcher.matches?(owner)
+    
+    #then
+    length_matcher.negative_failure_message.should == <<-EOF
+Isn't life confusing enough?
+Instead of having to figure out the meaning of this:
+  should_not have_at_most(3).items_in_collection_with_length_method
+We recommend that you use this instead:
+  should have_at_least(4).items_in_collection_with_length_method
+EOF
+    
+    size_matcher.negative_failure_message.should == <<-EOF
+Isn't life confusing enough?
+Instead of having to figure out the meaning of this:
+  should_not have_at_most(3).items_in_collection_with_size_method
+We recommend that you use this instead:
+  should have_at_least(4).items_in_collection_with_size_method
+EOF
+  end
+end
+
+context "have(n).items(args, block)" do
+  specify "should pass args to target" do
+    target = mock("target")
+    target.should_receive(:items).with("arg1","arg2").and_return([1,2,3])
+    target.should have(3).items("arg1","arg2")
+  end
+
+  specify "should pass block to target" do
+    target = mock("target")
+    block = lambda { 5 }
+    target.should_receive(:items).with("arg1","arg2", block).and_return([1,2,3])
+    target.should have(3).items("arg1","arg2", block)
+  end
+end
+
+context "have(n).items where target IS a collection" do
+  specify "should reference the number of items IN the collection" do
+    [1,2,3].should have(3).items
+  end
+
+  specify "should reference the number of items IN the collection" do
+    lambda { [1,2,3].should have(7).items }.should_fail_with("expected 7 items, got 3")
+  end
+end
+
+context "have(n).characters where target IS a String" do
+  specify "should pass if the length is correct" do
+    "this string".should have(11).characters
+  end
+
+  specify "should fail if the length is incorrect" do
+    lambda { "this string".should have(12).characters }.should_fail_with("expected 12 characters, got 11")
+  end
+end
+
+context "have(n).things on an object which is not a collection nor contains one" do
+  specify "should fail" do
+    lambda { Object.new.should have(2).things }.should_raise(NoMethodError, /undefined method `things' for #<Object:/)
+  end
+end