rspec-expectations 2.0.0.a1 → 2.0.0.a2

data/spec/rspec/matchers/compatibility_spec.rb

@@ -0,0 +1,28 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+Rspec::Matchers.define :have_public_instance_method do |method|
+  match do |klass|
+    klass.public_instance_methods.any? {|m| [method, method.to_sym].include?(m)}
+  end
+end
+
+(Rspec::Matchers.constants.sort).each do |c|
+  if (Class === (klass = Rspec::Matchers.const_get(c)))
+    describe klass do
+      if klass.public_instance_methods.any? {|m| ['failure_message_for_should',:failure_message_for_should].include?(m)}
+        describe "called with should" do
+          subject { klass }
+          it { should have_public_instance_method('failure_message_for_should')}
+          it { should have_public_instance_method('failure_message')}
+        end
+      end
+      if klass.public_instance_methods.any? {|m| ['failure_message_for_should_not',:failure_message_for_should_not].include?(m)}
+        describe "called with should not" do
+          subject { klass }
+          it { should have_public_instance_method('failure_message_for_should_not')}
+          it { should have_public_instance_method('negative_failure_message')}
+        end
+      end
+    end
+  end
+end

data/spec/rspec/matchers/description_generation_spec.rb

@@ -0,0 +1,160 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+describe "Matchers should be able to generate their own descriptions" do
+  after(:each) do
+    Rspec::Matchers.clear_generated_description
+  end
+
+  it "should == expected" do
+    "this".should == "this"
+    Rspec::Matchers.generated_description.should == "should == \"this\""
+  end
+  
+  it "should not == expected" do
+    "this".should_not == "that"
+    Rspec::Matchers.generated_description.should == "should not == \"that\""
+  end
+  
+  it "should be empty (arbitrary predicate)" do
+    [].should be_empty
+    Rspec::Matchers.generated_description.should == "should be empty"
+  end
+  
+  it "should not be empty (arbitrary predicate)" do
+    [1].should_not be_empty
+    Rspec::Matchers.generated_description.should == "should not be empty"
+  end
+  
+  it "should be true" do
+    true.should be_true
+    Rspec::Matchers.generated_description.should == "should be true"
+  end
+  
+  it "should be false" do
+    false.should be_false
+    Rspec::Matchers.generated_description.should == "should be false"
+  end
+  
+  it "should be nil" do
+    nil.should be_nil
+    Rspec::Matchers.generated_description.should == "should be nil"
+  end
+  
+  it "should be > n" do
+    5.should be > 3
+    Rspec::Matchers.generated_description.should == "should be > 3"
+  end
+  
+  it "should be predicate arg1, arg2 and arg3" do
+    5.0.should be_between(0,10)
+    Rspec::Matchers.generated_description.should == "should be between 0 and 10"
+  end
+
+  it "should equal" do
+    expected = "expected"
+    expected.should equal(expected)
+    Rspec::Matchers.generated_description.should == "should equal \"expected\""
+  end
+  
+  it "should_not equal" do
+    5.should_not equal(37)
+    Rspec::Matchers.generated_description.should == "should not equal 37"
+  end
+  
+  it "should eql" do
+    "string".should eql("string")
+    Rspec::Matchers.generated_description.should == "should eql \"string\""
+  end
+  
+  it "should not eql" do
+    "a".should_not eql(:a)
+    Rspec::Matchers.generated_description.should == "should not eql :a"
+  end
+  
+  it "should have_key" do
+    {:a => "a"}.should have_key(:a)
+    Rspec::Matchers.generated_description.should == "should have key :a"
+  end
+  
+  it "should have n items" do
+    team.should have(3).players
+    Rspec::Matchers.generated_description.should == "should have 3 players"
+  end
+  
+  it "should have at least n items" do
+    team.should have_at_least(2).players
+    Rspec::Matchers.generated_description.should == "should have at least 2 players"
+  end
+  
+  it "should have at most n items" do
+    team.should have_at_most(4).players
+    Rspec::Matchers.generated_description.should == "should have at most 4 players"
+  end
+  
+  it "should include" do
+    [1,2,3].should include(3)
+    Rspec::Matchers.generated_description.should == "should include 3"
+  end
+
+  it "array.should =~ [1,2,3]" do
+    [1,2,3].should =~ [1,2,3]
+    Rspec::Matchers.generated_description.should == "should contain exactly 1, 2 and 3"
+  end
+  
+  it "should match" do
+    "this string".should match(/this string/)
+    Rspec::Matchers.generated_description.should == "should match /this string/"
+  end
+  
+  it "should raise_error" do
+    lambda { raise }.should raise_error
+    Rspec::Matchers.generated_description.should == "should raise Exception"
+  end
+  
+  it "should raise_error with type" do
+    lambda { raise }.should raise_error(RuntimeError)
+    Rspec::Matchers.generated_description.should == "should raise RuntimeError"
+  end
+  
+  it "should raise_error with type and message" do
+    lambda { raise "there was an error" }.should raise_error(RuntimeError, "there was an error")
+    Rspec::Matchers.generated_description.should == "should raise RuntimeError with \"there was an error\""
+  end
+  
+  it "should respond_to" do
+    [].should respond_to(:insert)
+    Rspec::Matchers.generated_description.should == "should respond to #insert"
+  end
+  
+  it "should throw symbol" do
+    lambda { throw :what_a_mess }.should throw_symbol
+    Rspec::Matchers.generated_description.should == "should throw a Symbol"
+  end
+  
+  it "should throw symbol (with named symbol)" do
+    lambda { throw :what_a_mess }.should throw_symbol(:what_a_mess)
+    Rspec::Matchers.generated_description.should == "should throw :what_a_mess"
+  end
+  
+  def team
+    Class.new do
+      def players
+        [1,2,3]
+      end
+    end.new
+  end
+end
+
+describe "a Matcher with no description" do
+  def matcher
+     Class.new do
+       def matches?(ignore); true; end
+       def failure_message; ""; end
+     end.new
+  end
+  
+  it "should provide a helpful message when used in a string-less example block" do
+    5.should matcher
+    Rspec::Matchers.generated_description.should =~ /When you call.*description method/m
+  end
+end

data/spec/rspec/matchers/dsl_spec.rb

@@ -0,0 +1,25 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+module Rspec
+  module Matchers
+    module DSL
+      describe "#define" do
+        it "creates a method that initializes a new matcher with the submitted name and expected arg" do
+          # FIXME - this expects new to be called, but we need something
+          # more robust - that expects new to be called with a specific
+          # block (lambda, proc, whatever)
+          mod = Module.new
+          mod.extend Rspec::Matchers::DSL
+          mod.define(:foo)
+    
+          obj = Object.new
+          obj.extend mod
+    
+          Rspec::Matchers::Matcher.should_receive(:new).with(:foo, 3)
+    
+          obj.foo(3)
+        end
+      end
+    end
+  end
+end

data/spec/rspec/matchers/eql_spec.rb

@@ -0,0 +1,33 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+module Rspec
+  module Matchers
+    describe "eql" do
+      it "should match when actual.eql?(expected)" do
+        1.should eql(1)
+      end
+      
+      it "should not match when !actual.eql?(expected)" do
+        1.should_not eql(2)
+      end
+      
+      it "should describe itself" do
+        matcher = eql(1)
+        matcher.matches?(1)
+        matcher.description.should == "eql 1"
+      end
+      
+      it "should provide message, expected and actual on #failure_message" do
+        matcher = eql("1")
+        matcher.matches?(1)
+        matcher.failure_message_for_should.should == "\nexpected \"1\"\n     got 1\n\n(compared using eql?)\n"
+      end
+      
+      it "should provide message, expected and actual on #negative_failure_message" do
+        matcher = eql(1)
+        matcher.matches?(1)
+        matcher.failure_message_for_should_not.should == "\nexpected 1 not to equal 1\n\n(compared using eql?)\n"
+      end
+    end
+  end
+end

data/spec/rspec/matchers/equal_spec.rb

@@ -0,0 +1,57 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+module Rspec
+  module Matchers
+    describe "equal" do
+      
+      def inspect_object(o)
+        "#<#{o.class}:#{o.object_id}> => #{o.inspect}"
+      end
+      
+      it "should match when actual.equal?(expected)" do
+        1.should equal(1)
+      end
+
+      it "should not match when !actual.equal?(expected)" do
+        1.should_not equal("1")
+      end
+      
+      it "should describe itself" do
+        matcher = equal(1)
+        matcher.matches?(1)
+        matcher.description.should == "equal 1"
+      end
+      
+      it "should provide message on #failure_message" do
+        expected, actual = "1", "1"
+        matcher = equal(expected)
+        matcher.matches?(actual)
+        
+        matcher.failure_message_for_should.should == <<-MESSAGE
+
+expected #{inspect_object(expected)}
+     got #{inspect_object(actual)}
+
+Compared using equal?, which compares object identity,
+but expected and actual are not the same object. Use
+'actual.should == expected' if you don't care about
+object identity in this example.
+
+MESSAGE
+      end
+      
+      it "should provide message on #negative_failure_message" do
+        expected = actual = "1"
+        matcher = equal(expected)
+        matcher.matches?(actual)
+        matcher.failure_message_for_should_not.should == <<-MESSAGE
+
+expected not #{inspect_object(expected)}
+         got #{inspect_object(actual)}
+
+Compared using equal?, which compares object identity.
+
+MESSAGE
+      end
+    end
+  end
+end

data/spec/rspec/matchers/exist_spec.rb

@@ -0,0 +1,65 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+class Substance
+  def initialize exists, description
+    @exists = exists
+    @description = description
+  end
+  def exist?(arg=nil)
+    @exists
+  end
+  def inspect
+    @description
+  end
+end
+  
+class SubstanceTester
+  include Rspec::Matchers
+  def initialize substance
+    @substance = substance
+  end
+  def should_exist
+    @substance.should exist
+  end
+end
+
+describe "should exist" do
+  
+  before(:each) do
+    @real = Substance.new true, 'something real'
+    @imaginary = Substance.new false, 'something imaginary'
+  end
+
+  describe "within an example group" do
+  
+    it "passes if target exists" do
+      @real.should exist
+    end
+  
+    it "passes if target exists with args" do
+      @real.should exist('this arg')
+    end
+  
+    it "fails if target does not exist" do
+      lambda { @imaginary.should exist }.should fail
+    end
+    
+    it "describes itself" do
+      exist.description.should == "exist"
+    end
+    
+    it "passes should_not exist if target doesn't exist" do
+      lambda { @real.should_not exist }.should fail
+    end
+  end
+
+  describe "outside of an example group" do
+
+    it "should pass if target exists" do
+      real_tester = SubstanceTester.new @real
+      real_tester.should_exist
+    end
+
+  end
+
+end

data/spec/rspec/matchers/has_spec.rb

@@ -0,0 +1,81 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+describe "should have_sym(*args)" do
+  it "should pass if #has_sym?(*args) returns true" do
+    {:a => "A"}.should have_key(:a)
+  end
+
+  it "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
+
+  it "should fail if #has_sym?(*args) returns nil" do
+    klass = Class.new do
+      def has_foo?
+      end
+    end
+    lambda {
+      klass.new.should have_foo
+    }.should fail_with("expected #has_foo?(nil) to return true, got false")
+  end
+
+  it "should fail if target does not respond to #has_sym?" do
+    lambda {
+      Object.new.should have_key(:a)
+    }.should raise_error(NoMethodError)
+  end
+  
+  it "should reraise an exception thrown in #has_sym?(*args)" do
+    o = Object.new
+    def o.has_sym?(*args)
+      raise "Funky exception"
+    end
+    lambda { o.should have_sym(:foo) }.should raise_error("Funky exception")
+  end
+end
+
+describe "should_not have_sym(*args)" do
+  it "should pass if #has_sym?(*args) returns false" do
+    {:a => "A"}.should_not have_key(:b)
+  end
+
+  it "should pass if #has_sym?(*args) returns nil" do
+    klass = Class.new do
+      def has_foo?
+      end
+    end
+    klass.new.should_not have_foo
+  end
+
+  it "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
+
+  it "should fail if target does not respond to #has_sym?" do
+    lambda {
+      Object.new.should have_key(:a)
+    }.should raise_error(NoMethodError)
+  end
+  
+  it "should reraise an exception thrown in #has_sym?(*args)" do
+    o = Object.new
+    def o.has_sym?(*args)
+      raise "Funky exception"
+    end
+    lambda { o.should_not have_sym(:foo) }.should raise_error("Funky exception")
+  end
+end
+
+describe "has" do
+  it "should work when the target implements #send" do
+    o = {:a => "A"}
+    def o.send(*args); raise "DOH! Library developers shouldn't use #send!" end
+    lambda {
+      o.should have_key(:a)
+    }.should_not raise_error
+  end
+end