rspec-expectations 2.11.3 → 3.11.0

data/spec/rspec/matchers/matcher_spec.rb

@@ -1,434 +0,0 @@
-require 'spec_helper'
-
-class UnexpectedError < StandardError; end
-module MatcherHelperModule
-  def self.included(base)
-    base.module_eval do
-      def included_method; end
-    end
-  end
-
-  def self.extended(base)
-    base.instance_eval do
-      def extended_method; end
-    end
-  end
-
-  def greeting
-    "Hello, World"
-  end
-end
-
-module RSpec::Matchers::DSL
-  describe Matcher do
-    it "can be stored aside and used later" do
-      # Supports using rspec-expectation matchers as argument matchers in
-      # rspec-mocks.
-      RSpec::Matchers.define :example_matcher do |expected|
-        match do |actual|
-          actual == expected
-        end
-      end
-
-      m1 = example_matcher(1)
-      m2 = example_matcher(2)
-
-      m1.matches?(1).should be_true
-      m2.matches?(2).should be_true
-    end
-
-    context "with an included module" do
-      let(:matcher) do
-        RSpec::Matchers::DSL::Matcher.new(:be_a_greeting) do
-          include MatcherHelperModule
-          match { |actual| actual == greeting }
-        end.for_expected
-      end
-
-      it "has access to the module's methods" do
-        matcher.matches?("Hello, World")
-      end
-
-      it "runs the module's included hook" do
-        matcher.should respond_to(:included_method)
-      end
-
-      it "does not run the module's extended hook" do
-        matcher.should_not respond_to(:extended_method)
-      end
-
-      it 'allows multiple modules to be included at once' do
-        m = RSpec::Matchers::DSL::Matcher.new(:multiple_modules) do
-          include Enumerable, Comparable
-        end.for_expected
-        m.should be_a(Enumerable)
-        m.should be_a(Comparable)
-      end
-    end
-
-    context "without overrides" do
-      before(:each) do
-        @matcher = RSpec::Matchers::DSL::Matcher.new(:be_a_multiple_of) do |multiple|
-          match do |actual|
-            actual % multiple == 0
-          end
-        end.for_expected(3)
-      end
-
-      it "provides a default description" do
-        @matcher.description.should == "be a multiple of 3"
-      end
-
-      it "provides a default failure message for #should" do
-        @matcher.matches?(8)
-        @matcher.failure_message_for_should.should == "expected 8 to be a multiple of 3"
-      end
-
-      it "provides a default failure message for #should_not" do
-        @matcher.matches?(9)
-        @matcher.failure_message_for_should_not.should == "expected 9 not to be a multiple of 3"
-      end
-    end
-
-    context "with separate match logic for should and should not" do
-      let(:matcher) do
-        RSpec::Matchers::DSL::Matcher.new(:to_be_composed_of) do |a, b|
-          match_for_should do |actual|
-            actual == a * b
-          end
-
-          match_for_should_not do |actual|
-            actual == a + b
-          end
-        end.for_expected(7, 11)
-      end
-
-      it "invokes the match_for_should block for #matches?" do
-        matcher.matches?(77).should be_true
-        matcher.matches?(18).should be_false
-      end
-
-      it "invokes the match_for_should_not block for #does_not_match?" do
-        matcher.does_not_match?(77).should be_false
-        matcher.does_not_match?(18).should be_true
-      end
-
-      it "provides a default failure message for #should_not" do
-        matcher.does_not_match?(77)
-        matcher.failure_message_for_should_not.should == "expected 77 not to to be composed of 7 and 11"
-      end
-    end
-
-    it "allows helper methods to be defined with #define_method to have access to matcher parameters" do
-      matcher = RSpec::Matchers::DSL::Matcher.new(:name) do |a, b|
-        define_method(:sum) { a + b }
-      end.for_expected(3,4)
-
-      matcher.sum.should == 7
-    end
-
-    it "is not diffable by default" do
-      matcher = RSpec::Matchers::DSL::Matcher.new(:name) {}
-      matcher.should_not be_diffable
-    end
-
-    it "is diffable when told to be" do
-      matcher = RSpec::Matchers::DSL::Matcher.new(:name) { diffable }.for_expected
-      matcher.should be_diffable
-    end
-
-    it "provides expected" do
-      matcher = RSpec::Matchers::DSL::Matcher.new(:name) {}.for_expected('expected string')
-      matcher.expected.should == ['expected string']
-    end
-
-    it "provides actual" do
-      matcher = RSpec::Matchers::DSL::Matcher.new(:name) do
-        match {|actual|}
-      end.for_expected('expected string')
-
-      matcher.matches?('actual string')
-
-      matcher.actual.should == 'actual string'
-    end
-
-    context "wrapping another expectation (should == ...)" do
-      it "returns true if the wrapped expectation passes" do
-        matcher = RSpec::Matchers::DSL::Matcher.new(:name) do |expected|
-          match do |actual|
-            actual.should == expected
-          end
-        end.for_expected('value')
-        matcher.matches?('value').should be_true
-      end
-
-      it "returns false if the wrapped expectation fails" do
-        matcher = RSpec::Matchers::DSL::Matcher.new(:name) do |expected|
-          match do |actual|
-            actual.should == expected
-          end
-        end.for_expected('value')
-        matcher.matches?('other value').should be_false
-      end
-    end
-
-    context "with overrides" do
-      before(:each) do
-        @matcher = RSpec::Matchers::DSL::Matcher.new(:be_boolean) do |boolean|
-          match do |actual|
-            actual
-          end
-          description do
-            "be the boolean #{boolean}"
-          end
-          failure_message_for_should do |actual|
-            "expected #{actual} to be the boolean #{boolean}"
-          end
-          failure_message_for_should_not do |actual|
-            "expected #{actual} not to be the boolean #{boolean}"
-          end
-        end.for_expected(true)
-      end
-
-      it "does not hide result of match block when true" do
-        @matcher.matches?(true).should be_true
-      end
-
-      it "does not hide result of match block when false" do
-        @matcher.matches?(false).should be_false
-      end
-
-      it "overrides the description" do
-        @matcher.description.should == "be the boolean true"
-      end
-
-      it "overrides the failure message for #should" do
-        @matcher.matches?(false)
-        @matcher.failure_message_for_should.should == "expected false to be the boolean true"
-      end
-
-      it "overrides the failure message for #should_not" do
-        @matcher.matches?(true)
-        @matcher.failure_message_for_should_not.should == "expected true not to be the boolean true"
-      end
-    end
-
-    context "#new" do
-      it "passes matches? arg to match block" do
-        matcher = RSpec::Matchers::DSL::Matcher.new(:ignore) do
-          match do |actual|
-            actual == 5
-          end
-        end.for_expected
-        matcher.matches?(5).should be_true
-      end
-
-      it "exposes arg submitted through #new to matcher block" do
-        matcher = RSpec::Matchers::DSL::Matcher.new(:ignore) do |expected|
-          match do |actual|
-            actual > expected
-          end
-        end.for_expected(4)
-        matcher.matches?(5).should be_true
-      end
-    end
-
-    context "with no args" do
-      before(:each) do
-        @matcher = RSpec::Matchers::DSL::Matcher.new(:matcher_name) do
-          match do |actual|
-            actual == 5
-          end
-        end.for_expected
-      end
-
-      it "matches" do
-        @matcher.matches?(5).should be_true
-      end
-
-      it "describes" do
-        @matcher.description.should == "matcher name"
-      end
-    end
-
-    context "with 1 arg" do
-      before(:each) do
-        @matcher = RSpec::Matchers::DSL::Matcher.new(:matcher_name) do |expected|
-          match do |actual|
-            actual == 5 && expected == 1
-          end
-        end.for_expected(1)
-      end
-
-      it "matches" do
-        @matcher.matches?(5).should be_true
-      end
-
-      it "describes" do
-        @matcher.description.should == "matcher name 1"
-      end
-    end
-
-    context "with multiple args" do
-      before(:each) do
-        @matcher = RSpec::Matchers::DSL::Matcher.new(:matcher_name) do |a,b,c,d|
-          match do |sum|
-            a + b + c + d == sum
-          end
-        end.for_expected(1,2,3,4)
-      end
-
-      it "matches" do
-        @matcher.matches?(10).should be_true
-      end
-
-      it "describes" do
-        @matcher.description.should == "matcher name 1, 2, 3, and 4"
-      end
-    end
-
-    it "supports helper methods" do
-      matcher = RSpec::Matchers::DSL::Matcher.new(:be_similar_to) do |sample|
-        match do |actual|
-          similar?(sample, actual)
-        end
-
-        def similar?(a, b)
-          a.sort == b.sort
-        end
-      end.for_expected([1,2,3])
-
-      matcher.matches?([2,3,1]).should be_true
-    end
-
-    it "supports fluent interface" do
-      matcher = RSpec::Matchers::DSL::Matcher.new(:first_word) do
-        def second_word
-          self
-        end
-      end.for_expected
-
-      matcher.second_word.should == matcher
-    end
-
-    it "treats method missing normally for undeclared methods" do
-      matcher = RSpec::Matchers::DSL::Matcher.new(:ignore) { }.for_expected
-      expect { matcher.non_existent_method }.to raise_error(NoMethodError)
-    end
-
-    it "has access to other matchers" do
-      matcher = RSpec::Matchers::DSL::Matcher.new(:ignore) do |expected|
-        match do |actual|
-          extend RSpec::Matchers
-          actual.should eql(5 + expected)
-        end
-      end.for_expected(3)
-
-      matcher.matches?(8).should be_true
-    end
-
-    describe "#match_unless_raises" do
-      context "with an assertion" do
-        let(:mod) do
-          Module.new do
-            def assert_equal(a,b)
-              a == b ? nil : (raise UnexpectedError.new("#{b} does not equal #{a}"))
-            end
-          end
-        end
-        let(:matcher) do
-          m = mod
-          RSpec::Matchers::DSL::Matcher.new :equal do |expected|
-            extend m
-            match_unless_raises UnexpectedError do
-              assert_equal expected, actual
-            end
-          end.for_expected(4)
-        end
-
-        context "with passing assertion" do
-          it "passes" do
-            matcher.matches?(4).should be_true
-          end
-        end
-
-        context "with failing assertion" do
-          it "fails" do
-            matcher.matches?(5).should be_false
-          end
-
-          it "provides the raised exception" do
-            matcher.matches?(5)
-            matcher.rescued_exception.message.
-              should eq("5 does not equal 4")
-          end
-        end
-      end
-
-      context "with an unexpected error" do
-        let(:matcher) do
-          RSpec::Matchers::DSL::Matcher.new :foo do |expected|
-            match_unless_raises SyntaxError do |actual|
-              raise "unexpected exception"
-            end
-          end.for_expected(:bar)
-        end
-
-        it "raises the error" do
-          expect do
-            matcher.matches?(:bar)
-          end.to raise_error("unexpected exception")
-        end
-      end
-
-    end
-
-    it "can define chainable methods" do
-      matcher = RSpec::Matchers::DSL::Matcher.new(:name) do
-        chain(:expecting) do |expected_value|
-          @expected_value = expected_value
-        end
-        match { |actual| actual == @expected_value }
-      end.for_expected
-
-      matcher.expecting('value').matches?('value').should be_true
-      matcher.expecting('value').matches?('other value').should be_false
-    end
-
-    it "prevents name collisions on chainable methods from different matchers" do
-      m1 = RSpec::Matchers::DSL::Matcher.new(:m1) { chain(:foo) { raise "foo in m1" } }.for_expected
-      m2 = RSpec::Matchers::DSL::Matcher.new(:m2) { chain(:foo) { raise "foo in m2" } }.for_expected
-
-      expect { m1.foo }.to raise_error("foo in m1")
-      expect { m2.foo }.to raise_error("foo in m2")
-    end
-
-    context "defined using the dsl" do
-      def a_method_in_the_example
-        "method defined in the example"
-      end
-
-      it "can access methods in the running example" do
-        RSpec::Matchers.define(:__access_running_example) do
-          match do |actual|
-            a_method_in_the_example == "method defined in the example"
-          end
-        end
-        example.should __access_running_example
-      end
-
-      it "raises NoMethodError for methods not in the running_example" do
-        RSpec::Matchers.define(:__raise_no_method_error) do
-          match do |actual|
-            a_method_not_in_the_example == "method defined in the example"
-          end
-        end
-
-        expect do
-          example.should __raise_no_method_error
-        end.to raise_error(/RSpec::Matchers::DSL::Matcher/)
-      end
-    end
-
-  end
-end

data/spec/rspec/matchers/matchers_spec.rb

@@ -1,31 +0,0 @@
-require 'spec_helper'
-
-module RSpec
-  describe Matchers do
-
-    let(:sample_matchers) do
-      [:be,
-       :be_close,
-       :be_instance_of,
-       :be_kind_of]
-    end
-
-    context "once required" do
-      it "includes itself in Test::Unit::TestCase" do
-        test_unit_case = Test::Unit::TestCase.allocate
-        sample_matchers.each do |sample_matcher|
-            test_unit_case.should respond_to(sample_matcher)
-        end
-      end
-
-      it "includes itself in MiniTest::Unit::TestCase", :if => defined?(MiniTest) do
-        minitest_case = MiniTest::Unit::TestCase.allocate
-        sample_matchers.each do |sample_matcher|
-            minitest_case.should respond_to(sample_matcher)
-        end
-      end
-
-    end
-
-  end
-end

data/spec/rspec/matchers/method_missing_spec.rb

@@ -1,24 +0,0 @@
-require 'spec_helper'
-
-shared_examples_for "a well-behaved method_missing hook" do
-  it "raises a NoMethodError (and not SystemStackError) for an undefined method" do
-    expect { subject.some_undefined_method }.to raise_error(NoMethodError)
-  end
-end
-
-describe "RSpec::Matchers method_missing hook" do
-  subject { self }
-
-  it_behaves_like "a well-behaved method_missing hook"
-
-  context 'when invoked in a Test::Unit::TestCase' do
-    subject { Test::Unit::TestCase.allocate }
-    it_behaves_like "a well-behaved method_missing hook"
-  end
-
-  context 'when invoked in a MiniTest::Unit::TestCase', :if => defined?(MiniTest) do
-    subject { MiniTest::Unit::TestCase.allocate }
-    it_behaves_like "a well-behaved method_missing hook"
-  end
-end
-

data/spec/rspec/matchers/operator_matcher_spec.rb

@@ -1,221 +0,0 @@
-require 'spec_helper'
-
-describe "should ==" do
-  
-  it "delegates message to target" do
-    subject = "apple"
-    subject.should_receive(:==).with("apple").and_return(true)
-    subject.should == "apple"
-  end
-  
-  it "returns true on success" do
-    subject = "apple"
-    (subject.should == "apple").should be_true
-  end
-  
-  it "fails when target.==(actual) returns false" do
-    subject = "apple"
-    RSpec::Expectations.should_receive(:fail_with).with(%[expected: "orange"\n     got: "apple" (using ==)], "orange", "apple")
-    subject.should == "orange"
-  end
-  
-end
-
-describe "unsupported operators", :if => RUBY_VERSION.to_f == 1.9 do
-  it "raises an appropriate error for should != expected" do
-    expect {
-      "apple".should != "pear"
-    }.to raise_error(/does not support `should != expected`.  Use `should_not == expected`/)
-  end
-
-  it "raises an appropriate error for should_not != expected" do
-    expect {
-      "apple".should_not != "pear"
-    }.to raise_error(/does not support `should_not != expected`.  Use `should == expected`/)
-  end
-
-  it "raises an appropriate error for should !~ expected" do
-    expect {
-      "apple".should !~ /regex/
-    }.to raise_error(/does not support `should !~ expected`.  Use `should_not =~ expected`/)
-  end
-
-  it "raises an appropriate error for should_not !~ expected" do
-    expect {
-      "apple".should_not !~ /regex/
-    }.to raise_error(/does not support `should_not !~ expected`.  Use `should =~ expected`/)
-  end
-end
-
-describe "should_not ==" do
-  
-  it "delegates message to target" do
-    subject = "orange"
-    subject.should_receive(:==).with("apple").and_return(false)
-    subject.should_not == "apple"
-  end
-  
-  it "returns true on success" do
-    subject = "apple"
-    (subject.should_not == "orange").should be_false
-  end
-
-  it "fails when target.==(actual) returns false" do
-    subject = "apple"
-    RSpec::Expectations.should_receive(:fail_with).with(%[expected not: == "apple"\n         got:    "apple"], "apple", "apple")
-    subject.should_not == "apple"
-  end
-  
-end
-
-describe "should ===" do
-  
-  it "delegates message to target" do
-    subject = "apple"
-    subject.should_receive(:===).with("apple").and_return(true)
-    subject.should === "apple"
-  end
-  
-  it "fails when target.===(actual) returns false" do
-    subject = "apple"
-    subject.should_receive(:===).with("orange").and_return(false)
-    RSpec::Expectations.should_receive(:fail_with).with(%[expected: "orange"\n     got: "apple" (using ===)], "orange", "apple")
-    subject.should === "orange"
-  end
-  
-end
-
-describe "should_not ===" do
-  
-  it "delegates message to target" do
-    subject = "orange"
-    subject.should_receive(:===).with("apple").and_return(false)
-    subject.should_not === "apple"
-  end
-  
-  it "fails when target.===(actual) returns false" do
-    subject = "apple"
-    subject.should_receive(:===).with("apple").and_return(true)
-    RSpec::Expectations.should_receive(:fail_with).with(%[expected not: === "apple"\n         got:     "apple"], "apple", "apple")
-    subject.should_not === "apple"
-  end
-
-end
-
-describe "should =~" do
-  
-  it "delegates message to target" do
-    subject = "foo"
-    subject.should_receive(:=~).with(/oo/).and_return(true)
-    subject.should =~ /oo/
-  end
-  
-  it "fails when target.=~(actual) returns false" do
-    subject = "fu"
-    subject.should_receive(:=~).with(/oo/).and_return(false)
-    RSpec::Expectations.should_receive(:fail_with).with(%[expected: /oo/\n     got: "fu" (using =~)], /oo/, "fu")
-    subject.should =~ /oo/
-  end
-
-end
-
-describe "should_not =~" do
-  
-  it "delegates message to target" do
-    subject = "fu"
-    subject.should_receive(:=~).with(/oo/).and_return(false)
-    subject.should_not =~ /oo/
-  end
-  
-  it "fails when target.=~(actual) returns false" do
-    subject = "foo"
-    subject.should_receive(:=~).with(/oo/).and_return(true)
-    RSpec::Expectations.should_receive(:fail_with).with(%[expected not: =~ /oo/\n         got:    "foo"], /oo/, "foo")
-    subject.should_not =~ /oo/
-  end
-
-end
-
-describe "should >" do
-  
-  it "passes if > passes" do
-    4.should > 3
-  end
-
-  it "fails if > fails" do
-    RSpec::Expectations.should_receive(:fail_with).with(%[expected: > 5\n     got:   4], 5, 4)
-    4.should > 5
-  end
-
-end
-
-describe "should >=" do
-  
-  it "passes if actual == expected" do
-    4.should >= 4
-  end
-
-  it "passes if actual > expected" do
-    4.should >= 3
-  end
-
-  it "fails if > fails" do
-    RSpec::Expectations.should_receive(:fail_with).with(%[expected: >= 5\n     got:    4], 5, 4)
-    4.should >= 5
-  end
-
-end
-
-describe "should <" do
-  
-  it "passes if < passes" do
-    4.should < 5
-  end
-
-  it "fails if > fails" do
-    RSpec::Expectations.should_receive(:fail_with).with(%[expected: < 3\n     got:   4], 3, 4)
-    4.should < 3
-  end
-
-end
-
-describe "should <=" do
-  
-  it "passes if actual == expected" do
-    4.should <= 4
-  end
-
-  it "passes if actual < expected" do
-    4.should <= 5
-  end
-
-  it "fails if > fails" do
-    RSpec::Expectations.should_receive(:fail_with).with(%[expected: <= 3\n     got:    4], 3, 4)
-    4.should <= 3
-  end
-
-end
-
-describe RSpec::Matchers::BuiltIn::PositiveOperatorMatcher do
-
-  it "works when the target has implemented #send" do
-    o = Object.new
-    def o.send(*args); raise "DOH! Library developers shouldn't use #send!" end
-    lambda {
-      o.should == o
-    }.should_not raise_error
-  end
-
-end
-
-describe RSpec::Matchers::BuiltIn::NegativeOperatorMatcher do
-
-  it "works when the target has implemented #send" do
-    o = Object.new
-    def o.send(*args); raise "DOH! Library developers shouldn't use #send!" end
-    lambda {
-      o.should_not == :foo
-    }.should_not raise_error
-  end
-
-end