rspec-expectations 2.0.0.a1

data/spec/rspec/expectations/extensions/kernel_spec.rb

@@ -0,0 +1,45 @@
+require File.dirname(__FILE__) + '/../../../spec_helper.rb'
+
+describe Object, "#should" do
+  before(:each) do
+    @target = "target"
+    @matcher = mock("matcher")
+    @matcher.stub!(:matches?).and_return(true)
+    @matcher.stub!(:failure_message_for_should)
+  end
+  
+  it "accepts and interacts with a matcher" do
+    @matcher.should_receive(:matches?).with(@target).and_return(true)    
+    @target.should @matcher
+  end
+  
+  it "asks for a failure_message_for_should when matches? returns false" do
+    @matcher.should_receive(:matches?).with(@target).and_return(false)
+    @matcher.should_receive(:failure_message_for_should).and_return("the failure message")
+    lambda {
+      @target.should @matcher
+    }.should fail_with("the failure message")
+  end
+end
+
+describe Object, "#should_not" do
+  before(:each) do
+    @target = "target"
+    @matcher = mock("matcher")
+  end
+  
+  it "accepts and interacts with a matcher" do
+    @matcher.should_receive(:matches?).with(@target).and_return(false)
+    @matcher.stub!(:failure_message_for_should_not)
+    
+    @target.should_not @matcher
+  end
+  
+  it "asks for a failure_message_for_should_not when matches? returns true" do
+    @matcher.should_receive(:matches?).with(@target).and_return(true)
+    @matcher.should_receive(:failure_message_for_should_not).and_return("the failure message for should not")
+    lambda {
+      @target.should_not @matcher
+    }.should fail_with("the failure message for should not")
+  end
+end

data/spec/rspec/expectations/fail_with_spec.rb

@@ -0,0 +1,88 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+describe Rspec::Expectations, "#fail_with with no diff" do
+  before(:each) do
+    @old_differ = Rspec::Expectations.differ
+    Rspec::Expectations.differ = nil
+  end
+  
+  it "should handle just a message" do
+    lambda {
+      Rspec::Expectations.fail_with "the message"
+    }.should fail_with("the message")
+  end
+  
+  after(:each) do
+    Rspec::Expectations.differ = @old_differ
+  end
+end
+
+describe Rspec::Expectations, "#fail_with with Array" do
+  before(:each) do
+    Rspec::Core.stub!(:warn)
+  end
+  
+  it "is deprecated" do
+    Rspec::Core.should_receive(:warn)
+    lambda {
+      Rspec::Expectations.fail_with ["message", "expected", "actual"]
+    }.should raise_error
+  end
+end
+
+describe Rspec::Expectations, "#fail_with with diff" do
+  before(:each) do
+    @old_differ = Rspec::Expectations.differ
+    @differ = mock("differ")
+    Rspec::Expectations.differ = @differ
+  end
+  
+  it "should not call differ if no expected/actual" do
+    lambda {
+      Rspec::Expectations.fail_with "the message"
+    }.should fail_with("the message")
+  end
+  
+  it "should call differ if expected/actual are presented separately" do
+    @differ.should_receive(:diff_as_string).and_return("diff")
+    lambda {
+      Rspec::Expectations.fail_with "the message", "expected", "actual"
+    }.should fail_with("the message\nDiff:diff")
+  end
+  
+  it "should call differ if expected/actual are not strings" do
+    @differ.should_receive(:diff_as_object).and_return("diff")
+    lambda {
+      Rspec::Expectations.fail_with "the message", :expected, :actual
+    }.should fail_with("the message\nDiff:diff")
+  end
+  
+  it "should not call differ if expected or actual are procs" do
+    @differ.should_not_receive(:diff_as_string)
+    @differ.should_not_receive(:diff_as_object)
+    lambda {
+      Rspec::Expectations.fail_with "the message", lambda {}, lambda {}
+    }.should fail_with("the message")
+  end
+
+  after(:each) do
+    Rspec::Expectations.differ = @old_differ
+  end
+end
+
+describe Rspec::Expectations, "#fail_with with a nil message" do
+  before(:each) do
+    @old_differ = Rspec::Expectations.differ
+    Rspec::Expectations.differ = nil
+  end
+
+  it "should handle just a message" do
+    lambda {
+      Rspec::Expectations.fail_with nil
+    }.should raise_error(ArgumentError, /Failure message is nil\. Does your matcher define the appropriate failure_message_for_\* method to return a string\?/)
+  end
+
+  after(:each) do
+    Rspec::Expectations.differ = @old_differ
+  end
+end

data/spec/rspec/expectations/handler_spec.rb

@@ -0,0 +1,206 @@
+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
+      @expected = block.call if block
+      @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 rescue nil
+  end
+  
+  def arbitrary_matcher(*args, &block)
+    ArbitraryMatcher.new(*args, &block)
+  end
+  
+  def positive_only_matcher(*args, &block)
+    PositiveOnlyMatcher.new(*args, &block)
+  end
+  
+end
+
+module Rspec
+  module Expectations
+    describe PositiveExpectationHandler do
+      describe "#handle_matcher" do
+        it "asks the matcher if it matches" do
+          matcher = mock("matcher")
+          actual = Object.new
+          matcher.should_receive(:matches?).with(actual).and_return(true)
+          Rspec::Expectations::PositiveExpectationHandler.handle_matcher(actual, matcher)
+        end
+      
+        it "returns the match value" do
+          matcher = mock("matcher")
+          actual = Object.new
+          matcher.should_receive(:matches?).with(actual).and_return(:this_value)
+          Rspec::Expectations::PositiveExpectationHandler.handle_matcher(actual, matcher).should == :this_value
+        end
+        
+        it "calls failure_message_for_should if the matcher implements it" do
+          matcher = mock("matcher", :failure_message_for_should => "message", :matches? => false)
+          actual = Object.new
+          
+          ::Rspec::Expectations.should_receive(:fail_with).with("message")
+          
+          Rspec::Expectations::PositiveExpectationHandler.handle_matcher(actual, matcher)
+        end
+        
+        it "calls fail if matcher.diffable?" do
+          matcher = mock("matcher",
+            :diffable? => true,
+            :failure_message_for_should => "message",
+            :matches? => false,
+            :expected => [1],
+            :actual   => 2
+          )
+          actual = Object.new
+          
+          ::Rspec::Expectations.should_receive(:fail_with).with("message", 1, 2)
+          
+          Rspec::Expectations::PositiveExpectationHandler.handle_matcher(actual, matcher)
+        end
+        
+        it "calls failure_message if the matcher does not implement failure_message_for_should" do
+          matcher = mock("matcher", :failure_message => "message", :matches? => false)
+          actual = Object.new
+          
+          ::Rspec::Expectations.should_receive(:fail_with).with("message")
+          
+          Rspec::Expectations::PositiveExpectationHandler.handle_matcher(actual, matcher)
+          
+        end
+        
+        it "appends the :or message in the options hash passed to should" do
+          matcher = mock("matcher", :failure_message_for_should => "message", :matches? => false)
+          actual = Object.new
+          
+          ::Rspec::Expectations.should_receive(:fail_with).with("custom")
+          
+          Rspec::Expectations::PositiveExpectationHandler.handle_matcher(actual, matcher, "custom")
+        end
+      end
+    end
+
+    describe NegativeExpectationHandler do
+      describe "#handle_matcher" do
+        it "asks the matcher if it doesn't match when the matcher responds to #does_not_match?" do
+          matcher = mock("matcher", :does_not_match? => true, :negative_failure_message => nil)
+          actual = Object.new
+          matcher.should_receive(:does_not_match?).with(actual).and_return(true)
+          Rspec::Expectations::NegativeExpectationHandler.handle_matcher(actual, matcher)
+        end
+
+        it "asks the matcher if it matches when the matcher doesn't respond to #does_not_match?" do
+          matcher = mock("matcher")
+          actual = Object.new
+          matcher.stub!(:negative_failure_message)
+          matcher.should_receive(:matches?).with(actual).and_return(false)
+          Rspec::Expectations::NegativeExpectationHandler.handle_matcher(actual, matcher)
+        end
+      
+        it "returns the match value" do
+          matcher = mock("matcher")
+          actual = Object.new
+          matcher.should_receive(:matches?).with(actual).and_return(false)
+          matcher.stub!(:negative_failure_message).and_return("ignore")
+          Rspec::Expectations::NegativeExpectationHandler.handle_matcher(actual, matcher).should be_false
+        end
+
+        
+        it "calls failure_message_for_should_not if the matcher implements it" do
+          matcher = mock("matcher", :failure_message_for_should_not => "message", :matches? => true)
+          actual = Object.new
+          
+          ::Rspec::Expectations.should_receive(:fail_with).with("message")
+          
+          Rspec::Expectations::NegativeExpectationHandler.handle_matcher(actual, matcher)
+          
+        end
+        
+        it "calls negative_failure_message if the matcher does not implement failure_message_for_should_not" do
+          matcher = mock("matcher", :negative_failure_message => "message", :matches? => true)
+          actual = Object.new
+          
+          ::Rspec::Expectations.should_receive(:fail_with).with("message")
+          
+          Rspec::Expectations::NegativeExpectationHandler.handle_matcher(actual, matcher)
+          
+        end
+
+        
+        it "calls fail if matcher.diffable?" do
+          matcher = mock("matcher",
+            :diffable? => true,
+            :failure_message_for_should_not => "message",
+            :matches? => true,
+            :expected => [1],
+            :actual   => 2
+          )
+          actual = Object.new
+          
+          ::Rspec::Expectations.should_receive(:fail_with).with("message", 1, 2)
+          
+          Rspec::Expectations::NegativeExpectationHandler.handle_matcher(actual, matcher)
+        end
+
+        it "appends the :or message in the options hash passed to should" do
+          matcher = mock("matcher", :failure_message_for_should_not => "message", :matches? => true)
+          actual = Object.new
+          
+          ::Rspec::Expectations.should_receive(:fail_with).with("custom")
+          
+          Rspec::Expectations::NegativeExpectationHandler.handle_matcher(actual, matcher, "custom")
+        end
+
+      end
+    end
+    
+    describe PositiveExpectationHandler do
+      include ExampleExpectations
+      
+      it "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
+
+      it "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
+  
+    end
+  end
+end

data/spec/rspec/expectations/wrap_expectation_spec.rb

@@ -0,0 +1,30 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+module Rspec
+  module Matchers
+    describe "wrap_expectation" do
+      
+      def stub_matcher
+        @_stub_matcher ||= simple_matcher do
+        end
+      end
+      
+      def failing_matcher
+        @_failing_matcher ||= simple_matcher do
+          1.should == 2
+        end
+      end
+      
+      it "should return true if there is no error" do
+        wrap_expectation stub_matcher do
+        end.should be_true
+      end
+      
+      it "should return false if there is an error" do
+        wrap_expectation failing_matcher do
+          raise "error"
+        end.should be_false
+      end
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,6 @@
+--colour
+--format
+profile
+--timeout
+20
+--diff

data/spec/spec_helper.rb

@@ -0,0 +1,31 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '../../core/lib'))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '../../mocks/lib'))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'rspec/expectations'
+require 'rspec/mocks'
+require 'rspec/core'
+
+module Rspec
+  module Ruby
+    class << self
+      def version
+        RUBY_VERSION
+      end
+    end
+  end
+end
+
+module Rspec  
+  module Matchers
+    def fail_with(message)
+      raise_error(Rspec::Expectations::ExpectationNotMetError, message)
+    end
+  end
+end
+
+Rspec::Core::configure do |config|
+  config.mock_with(:rspec)
+  config.include Rspec::Mocks::Methods
+  config.include Rspec::Matchers
+  config.color_enabled = true
+end

data/spec/suite.rb

@@ -0,0 +1 @@
+Dir["spec/**/*_spec.rb"].each {|f| require f}

data/spec/support/macros.rb

@@ -0,0 +1,29 @@
+module Macros
+  def treats_method_missing_as_private(options = {:noop => true, :subject => nil})
+    it "should have method_missing as private" do
+      with_ruby 1.8 do
+        described_class.private_instance_methods.should include("method_missing")
+      end
+      with_ruby 1.9 do
+        described_class.private_instance_methods.should include(:method_missing)
+      end
+    end
+
+    it "should not respond_to? method_missing (because it's private)" do
+      formatter = options[:subject] || described_class.new({ }, StringIO.new)
+      formatter.should_not respond_to(:method_missing)
+    end
+
+    if options[:noop]
+      it "should respond_to? all messages" do
+        formatter = described_class.new({ }, StringIO.new)
+        formatter.should respond_to(:just_about_anything)
+      end
+
+      it "should respond_to? anything, when given the private flag" do
+        formatter = described_class.new({ }, StringIO.new)
+        formatter.respond_to?(:method_missing, true).should be_true
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification 
+name: rspec-expectations
+version: !ruby/object:Gem::Version 
+  version: 2.0.0.a1
+platform: ruby
+authors: 
+- David Chelimsky
+- Chad Humphries
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-09-16 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec-core
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.0.a1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec-mocks
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.0.0.a1
+    version: 
+description: 
+email: dchelimsky@gmail.com;chad.humphries@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- .document
+- .gitignore
+- License.txt
+- README.markdown
+- Rakefile
+- VERSION
+- VERSION.yml
+- lib/rspec/expectations.rb
+- lib/rspec/expectations/differs/default.rb
+- lib/rspec/expectations/differs/load-diff-lcs.rb
+- lib/rspec/expectations/errors.rb
+- lib/rspec/expectations/extensions.rb
+- lib/rspec/expectations/extensions/kernel.rb
+- lib/rspec/expectations/fail_with.rb
+- lib/rspec/expectations/handler.rb
+- lib/rspec/matchers.rb
+- lib/rspec/matchers/be.rb
+- lib/rspec/matchers/be_close.rb
+- lib/rspec/matchers/be_instance_of.rb
+- lib/rspec/matchers/be_kind_of.rb
+- lib/rspec/matchers/change.rb
+- lib/rspec/matchers/compatibility.rb
+- lib/rspec/matchers/dsl.rb
+- lib/rspec/matchers/eql.rb
+- lib/rspec/matchers/equal.rb
+- lib/rspec/matchers/errors.rb
+- lib/rspec/matchers/exist.rb
+- lib/rspec/matchers/extensions/instance_exec.rb
+- lib/rspec/matchers/generated_descriptions.rb
+- lib/rspec/matchers/has.rb
+- lib/rspec/matchers/have.rb
+- lib/rspec/matchers/include.rb
+- lib/rspec/matchers/match.rb
+- lib/rspec/matchers/match_array.rb
+- lib/rspec/matchers/matcher.rb
+- lib/rspec/matchers/method_missing.rb
+- lib/rspec/matchers/operator_matcher.rb
+- lib/rspec/matchers/pretty.rb
+- lib/rspec/matchers/raise_error.rb
+- lib/rspec/matchers/respond_to.rb
+- lib/rspec/matchers/satisfy.rb
+- lib/rspec/matchers/simple_matcher.rb
+- lib/rspec/matchers/throw_symbol.rb
+- lib/rspec/matchers/wrap_expectation.rb
+- rspec-expectations.gemspec
+- spec/rspec/expectations/differs/default_spec.rb
+- spec/rspec/expectations/extensions/kernel_spec.rb
+- spec/rspec/expectations/fail_with_spec.rb
+- spec/rspec/expectations/handler_spec.rb
+- spec/rspec/expectations/wrap_expectation_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/suite.rb
+- spec/support/macros.rb
+has_rdoc: true
+homepage: http://github.com/rspec/expectations
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: rspec expectations (should[_not] and matchers)
+test_files: 
+- spec/rspec/expectations/differs/default_spec.rb
+- spec/rspec/expectations/extensions/kernel_spec.rb
+- spec/rspec/expectations/fail_with_spec.rb
+- spec/rspec/expectations/handler_spec.rb
+- spec/rspec/expectations/wrap_expectation_spec.rb
+- spec/spec_helper.rb
+- spec/suite.rb
+- spec/support/macros.rb