rspec-expectations 2.13.0 → 3.0.0

data/lib/rspec/matchers/matcher.rb

@@ -1,300 +0,0 @@
-require 'set'
-
-module RSpec
-  module Matchers
-    module DSL
-      # Provides the context in which the block passed to RSpec::Matchers.define
-      # will be evaluated.
-      class Matcher
-        include RSpec::Matchers::Extensions::InstanceEvalWithArgs
-        include RSpec::Matchers::Pretty
-        include RSpec::Matchers
-
-        attr_reader :expected, :actual, :rescued_exception
-        attr_accessor :matcher_execution_context
-
-        # @api private
-        def initialize(name, &declarations)
-          @name         = name
-          @declarations = declarations
-          @actual       = nil
-          @diffable     = false
-          @expected_exception, @rescued_exception = nil, nil
-          @match_for_should_not_block = nil
-          @messages = {}
-        end
-
-        PERSISTENT_INSTANCE_VARIABLES = [
-          :@name, :@declarations, :@diffable,
-          :@match_block, :@match_for_should_not_block,
-          :@expected_exception
-        ].to_set
-
-        # @api private
-        def for_expected(*expected)
-          @expected = expected
-          dup.instance_eval do
-            instance_variables.map {|ivar| ivar.intern}.each do |ivar|
-              instance_variable_set(ivar, nil) unless (PERSISTENT_INSTANCE_VARIABLES + [:@expected]).include?(ivar)
-            end
-            @messages = {}
-            making_declared_methods_public do
-              instance_eval_with_args(*@expected, &@declarations)
-            end
-            self
-          end
-        end
-
-        # @api private
-        # Used internally by +should+ and +should_not+.
-        def matches?(actual)
-          @actual = actual
-          if @expected_exception
-            begin
-              instance_eval_with_args(actual, &@match_block)
-              true
-            rescue @expected_exception => @rescued_exception
-              false
-            end
-          else
-            begin
-              instance_eval_with_args(actual, &@match_block)
-            rescue RSpec::Expectations::ExpectationNotMetError
-              false
-            end
-          end
-        end
-
-        # Stores the block that is used to determine whether this matcher passes
-        # or fails. The block should return a boolean value. When the matcher is
-        # passed to `should` and the block returns `true`, then the expectation
-        # passes. Similarly, when the matcher is passed to `should_not` and the
-        # block returns `false`, then the expectation passes.
-        #
-        # Use `match_for_should` when used in conjuntion with
-        # `match_for_should_not`.
-        #
-        # @example
-        #
-        #     RSpec::Matchers.define :be_even do
-        #       match do |actual|
-        #         actual.even?
-        #       end
-        #     end
-        #
-        #     4.should be_even     # passes
-        #     3.should_not be_even # passes
-        #     3.should be_even     # fails
-        #     4.should_not be_even # fails
-        #
-        # @yield [Object] actual the actual value (or receiver of should)
-        def match(&block)
-          @match_block = block
-        end
-
-        alias_method :match_for_should, :match
-
-        # Use this to define the block for a negative expectation (`should_not`)
-        # when the positive and negative forms require different handling. This
-        # is rarely necessary, but can be helpful, for example, when specifying
-        # asynchronous processes that require different timeouts.
-        #
-        # @yield [Object] actual the actual value (or receiver of should)
-        def match_for_should_not(&block)
-          @match_for_should_not_block = block
-        end
-
-        # Use this instead of `match` when the block will raise an exception
-        # rather than returning false to indicate a failure.
-        #
-        # @example
-        #
-        #     RSpec::Matchers.define :accept_as_valid do |candidate_address|
-        #       match_unless_raises ValidationException do |validator|
-        #         validator.validate(candidate_address)
-        #       end
-        #     end
-        #
-        #     email_validator.should accept_as_valid("person@company.com")
-        def match_unless_raises(exception=Exception, &block)
-          @expected_exception = exception
-          match(&block)
-        end
-
-        # Customize the failure messsage to use when this matcher is invoked with
-        # `should`. Only use this when the message generated by default doesn't
-        # suit your needs.
-        #
-        # @example
-        #
-        #     RSpec::Matchers.define :have_strength do |expected|
-        #       match { ... }
-        #
-        #       failure_message_for_should do |actual|
-        #         "Expected strength of #{expected}, but had #{actual.strength}"
-        #       end
-        #     end
-        #
-        # @yield [Object] actual the actual object
-        def failure_message_for_should(&block)
-          cache_or_call_cached(:failure_message_for_should, &block)
-        end
-
-        # Customize the failure messsage to use when this matcher is invoked with
-        # `should_not`. Only use this when the message generated by default
-        # doesn't suit your needs.
-        #
-        # @example
-        #
-        #     RSpec::Matchers.define :have_strength do |expected|
-        #       match { ... }
-        #
-        #       failure_message_for_should_not do |actual|
-        #         "Expected not to have strength of #{expected}, but did"
-        #       end
-        #     end
-        #
-        # @yield [Object] actual the actual object
-        # @yield [Object] actual the actual object
-        def failure_message_for_should_not(&block)
-          cache_or_call_cached(:failure_message_for_should_not, &block)
-        end
-
-
-        # Customize the description to use for one-liners.  Only use this when
-        # the description generated by default doesn't suit your needs.
-        #
-        # @example
-        #
-        #     RSpec::Matchers.define :qualify_for do |expected|
-        #       match { ... }
-        #
-        #       description do
-        #         "qualify for #{expected}"
-        #       end
-        #     end
-        def description(&block)
-          cache_or_call_cached(:description, &block)
-        end
-
-        # Tells the matcher to diff the actual and expected values in the failure
-        # message.
-        def diffable
-          @diffable = true
-        end
-
-        # Convenience for defining methods on this matcher to create a fluent
-        # interface. The trick about fluent interfaces is that each method must
-        # return self in order to chain methods together. `chain` handles that
-        # for you.
-        #
-        # @example
-        #
-        #     RSpec::Matchers.define :have_errors_on do |key|
-        #       chain :with do |message|
-        #         @message = message
-        #       end
-        #
-        #       match do |actual|
-        #         actual.errors[key] == @message
-        #       end
-        #     end
-        #
-        #     minor.should have_errors_on(:age).with("Not old enough to participate")
-        def chain(method, &block)
-          define_method method do |*args|
-            block.call(*args)
-            self
-          end
-        end
-
-        # @api private
-        # Used internally by objects returns by +should+ and +should_not+.
-        def diffable?
-          @diffable
-        end
-
-        # @api private
-        # Used internally by +should_not+
-        def does_not_match?(actual)
-          @actual = actual
-          @match_for_should_not_block ?
-            instance_eval_with_args(actual, &@match_for_should_not_block) :
-            !matches?(actual)
-        end
-
-        def respond_to?(method, include_private=false)
-          super || matcher_execution_context.respond_to?(method, include_private)
-        end
-
-        private
-
-        def method_missing(method, *args, &block)
-          if matcher_execution_context.respond_to?(method)
-            matcher_execution_context.__send__ method, *args, &block
-          else
-            super(method, *args, &block)
-          end
-        end
-
-        def include(*args)
-          singleton_class.__send__(:include, *args)
-        end
-
-        def define_method(name, &block)
-          singleton_class.__send__(:define_method, name, &block)
-        end
-
-        def making_declared_methods_public
-          # Our home-grown instance_exec in ruby 1.8.6 results in any methods
-          # declared in the block eval'd by instance_exec in the block to which we
-          # are yielding here are scoped private. This is NOT the case for Ruby
-          # 1.8.7 or 1.9.
-          #
-          # Also, due some crazy scoping that I don't understand, these methods
-          # are actually available in the specs (something about the matcher being
-          # defined in the scope of RSpec::Matchers or within an example), so not
-          # doing the following will not cause specs to fail, but they *will*
-          # cause features to fail and that will make users unhappy. So don't.
-          orig_private_methods = private_methods
-          yield
-          (private_methods - orig_private_methods).each {|m| singleton_class.__send__ :public, m}
-        end
-
-        def cache_or_call_cached(key, &block)
-          block ? cache(key, &block) : call_cached(key)
-        end
-
-        def cache(key, &block)
-          @messages[key] = block
-        end
-
-        def call_cached(key)
-          if @messages.has_key?(key)
-            @messages[key].arity == 1 ? @messages[key].call(@actual) : @messages[key].call
-          else
-            __send__("default_#{key}")
-          end
-        end
-
-        def default_description
-          "#{name_to_sentence}#{expected_to_sentence}"
-        end
-
-        def default_failure_message_for_should
-          "expected #{actual.inspect} to #{name_to_sentence}#{expected_to_sentence}"
-        end
-
-        def default_failure_message_for_should_not
-          "expected #{actual.inspect} not to #{name_to_sentence}#{expected_to_sentence}"
-        end
-
-        unless method_defined?(:singleton_class)
-          def singleton_class
-            class << self; self; end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/rspec/matchers/method_missing.rb

@@ -1,12 +0,0 @@
-module RSpec
-  module Matchers
-
-    private
-
-    def method_missing(method, *args, &block)
-      return Matchers::BuiltIn::BePredicate.new(method, *args, &block) if method.to_s =~ /^be_/
-      return Matchers::BuiltIn::Has.new(method, *args, &block) if method.to_s =~ /^have_/
-      super
-    end
-  end
-end

data/lib/rspec/matchers/operator_matcher.rb

@@ -1,109 +0,0 @@
-module RSpec
-  module Matchers
-    class OperatorMatcher
-      class << self
-        def registry
-          @registry ||= {}
-        end
-
-        def register(klass, operator, matcher)
-          registry[klass] ||= {}
-          registry[klass][operator] = matcher
-        end
-
-        def unregister(klass, operator)
-          registry[klass] && registry[klass].delete(operator)
-        end
-
-        def get(klass, operator)
-          klass.ancestors.each { |ancestor|
-            matcher = registry[ancestor] && registry[ancestor][operator]
-            return matcher if matcher
-          }
-
-          nil
-        end
-      end
-
-      def initialize(actual)
-        @actual = actual
-      end
-
-      def self.use_custom_matcher_or_delegate(operator)
-        define_method(operator) do |expected|
-          if uses_generic_implementation_of?(operator) && matcher = OperatorMatcher.get(@actual.class, operator)
-            @actual.__send__(::RSpec::Matchers.last_should, matcher.new(expected))
-          else
-            eval_match(@actual, operator, expected)
-          end
-        end
-
-        negative_operator = operator.sub(/^=/, '!')
-        if negative_operator != operator && respond_to?(negative_operator)
-          define_method(negative_operator) do |expected|
-            opposite_should = ::RSpec::Matchers.last_should == :should ? :should_not : :should
-            raise "RSpec does not support `#{::RSpec::Matchers.last_should} #{negative_operator} expected`.  " +
-              "Use `#{opposite_should} #{operator} expected` instead."
-          end
-        end
-      end
-
-      ['==', '===', '=~', '>', '>=', '<', '<='].each do |operator|
-        use_custom_matcher_or_delegate operator
-      end
-
-      def fail_with_message(message)
-        RSpec::Expectations.fail_with(message, @expected, @actual)
-      end
-
-      def description
-        "#{@operator} #{@expected.inspect}"
-      end
-
-      private
-
-      if Method.method_defined?(:owner) # 1.8.6 lacks Method#owner :-(
-        def uses_generic_implementation_of?(op)
-          @actual.method(op).owner == ::Kernel
-        end
-      else
-        def uses_generic_implementation_of?(op)
-          # This is a bit of a hack, but:
-          #
-          # {}.method(:=~).to_s # => "#<Method: Hash(Kernel)#=~>"
-          #
-          # In the absence of Method#owner, this is the best we
-          # can do to see if the method comes from Kernel.
-          @actual.method(op).to_s.include?('(Kernel)')
-        end
-      end
-
-      def eval_match(actual, operator, expected)
-        ::RSpec::Matchers.last_matcher = self
-        @operator, @expected = operator, expected
-        __delegate_operator(actual, operator, expected)
-      end
-    end
-
-    module BuiltIn
-      class PositiveOperatorMatcher < OperatorMatcher
-        def __delegate_operator(actual, operator, expected)
-          if actual.__send__(operator, expected)
-            true
-          elsif ['==','===', '=~'].include?(operator)
-            fail_with_message("expected: #{expected.inspect}\n     got: #{actual.inspect} (using #{operator})") 
-          else
-            fail_with_message("expected: #{operator} #{expected.inspect}\n     got: #{operator.gsub(/./, ' ')} #{actual.inspect}")
-          end
-        end
-      end
-
-      class NegativeOperatorMatcher < OperatorMatcher
-        def __delegate_operator(actual, operator, expected)
-          return false unless actual.__send__(operator, expected)
-          return fail_with_message("expected not: #{operator} #{expected.inspect}\n         got: #{operator.gsub(/./, ' ')} #{actual.inspect}")
-        end
-      end
-    end
-  end
-end

data/lib/rspec-expectations.rb

@@ -1 +0,0 @@
-require "rspec/expectations"

data/spec/rspec/expectations/differ_spec.rb

@@ -1,170 +0,0 @@
-require 'spec_helper'
-require 'ostruct'
-
-module RSpec
-  module Expectations
-    describe Differ do
-      context "without --color" do
-
-      before { RSpec::Matchers.configuration.stub(:color? => false) }
-
-      let(:differ) { RSpec::Expectations::Differ.new }
-
-        # color disabled context
-
-      describe '#diff_as_string' do
-        it "outputs unified diff of two strings" do
-          expected="foo\nbar\nzap\nthis\nis\nsoo\nvery\nvery\nequal\ninsert\na\nline\n"
-          actual="foo\nzap\nbar\nthis\nis\nsoo\nvery\nvery\nequal\ninsert\na\nanother\nline\n"
-          expected_diff= <<'EOD'
-
-
-@@ -1,6 +1,6 @@
- foo
--zap
- bar
-+zap
- this
- is
- soo
-@@ -9,6 +9,5 @@
- equal
- insert
- a
--another
- line
-EOD
-
-          diff = differ.diff_as_string(expected, actual)
-          expect(diff).to eql(expected_diff)
-        end
-      end
-
-      describe '#diff_as_object' do
-        it "outputs unified diff message of two objects" do
-          animal_class = Class.new do
-            def initialize(name, species)
-              @name, @species = name, species
-            end
-
-            def inspect
-              <<-EOA
-<Animal
-  name=#{@name},
-  species=#{@species}
->
-              EOA
-            end
-          end
-
-          expected = animal_class.new "bob", "giraffe"
-          actual   = animal_class.new "bob", "tortoise"
-
-          expected_diff = <<'EOD'
-
-@@ -1,5 +1,5 @@
- <Animal
-   name=bob,
--  species=tortoise
-+  species=giraffe
- >
-EOD
-
-          diff = differ.diff_as_object(expected,actual)
-          expect(diff).to eq expected_diff
-        end
-
-        it "outputs unified diff message of two arrays" do
-          expected = [ :foo, 'bar', :baz, 'quux', :metasyntactic, 'variable', :delta, 'charlie', :width, 'quite wide' ]
-          actual   = [ :foo, 'bar', :baz, 'quux', :metasyntactic, 'variable', :delta, 'tango'  , :width, 'very wide'  ]
-
-          expected_diff = <<'EOD'
-
-
-@@ -5,7 +5,7 @@
-  :metasyntactic,
-  "variable",
-  :delta,
-- "tango",
-+ "charlie",
-  :width,
-- "very wide"]
-+ "quite wide"]
-EOD
-
-          diff = differ.diff_as_object(expected,actual)
-          expect(diff).to eq expected_diff
-        end
-
-        it "outputs unified diff message of two hashes" do
-          expected = { :foo => 'bar', :baz => 'quux', :metasyntactic => 'variable', :delta => 'charlie', :width =>'quite wide' }
-          actual   = { :foo => 'bar', :metasyntactic => 'variable', :delta => 'charlotte', :width =>'quite wide' }
-
-          expected_diff = <<'EOD'
-
-@@ -1,4 +1,5 @@
--:delta => "charlotte",
-+:baz => "quux",
-+:delta => "charlie",
- :foo => "bar",
- :metasyntactic => "variable",
- :width => "quite wide"
-EOD
-
-          diff = differ.diff_as_object(expected,actual)
-          expect(diff).to eq expected_diff
-        end
-
-        it "outputs unified diff of single line strings" do
-          expected = "this is one string"
-          actual   = "this is another string"
-
-          expected_diff = <<'EOD'
-
-@@ -1,2 +1,2 @@
--"this is another string"
-+"this is one string"
-EOD
-
-          diff = differ.diff_as_object(expected,actual)
-          expect(diff).to eq expected_diff
-        end
-
-        it "outputs unified diff of multi line strings" do
-          expected = "this is:\n  one string"
-          actual   = "this is:\n  another string"
-
-          expected_diff = <<'EOD'
-
-@@ -1,3 +1,3 @@
- this is:
--  another string
-+  one string
-EOD
-
-          diff = differ.diff_as_object(expected,actual)
-          expect(diff).to eq expected_diff
-        end
-      end
-    end
-
-    context "with --color" do
-      before { RSpec::Matchers.configuration.stub(:color? => true) }
-
-      let(:differ) { RSpec::Expectations::Differ.new }
-
-      it "outputs colored diffs" do
-        expected = "foo bar baz"
-        actual = "foo bang baz"
-        expected_diff = "\n\e[34m@@ -1,2 +1,2 @@\n\e[0m\e[31m-foo bang baz\n\e[0m\e[32m+foo bar baz\n\e[0m"
-
-
-        diff = differ.diff_as_string(expected,actual)
-        expect(diff).to eq expected_diff
-      end
-    end
-
-    end
-  end
-end
-

data/spec/rspec/expectations/expectation_target_spec.rb

@@ -1,75 +0,0 @@
-require 'spec_helper'
-
-module RSpec
-  module Expectations
-    # so our examples below can set expectations about the target
-    ExpectationTarget.send(:attr_reader, :target)
-
-    describe ExpectationTarget do
-      context 'when constructed via #expect' do
-        it 'constructs a new instance targetting the given argument' do
-          expect(expect(7).target).to eq(7)
-        end
-
-        it 'constructs a new instance targetting the given block' do
-          block = lambda {}
-          expect(expect(&block).target).to be(block)
-        end
-
-        it 'raises an ArgumentError when given an argument and a block' do
-          expect {
-            expect(7) { }
-          }.to raise_error(ArgumentError)
-        end
-
-        it 'raises an ArgumentError when given neither an argument nor a block' do
-          expect {
-            expect
-          }.to raise_error(ArgumentError)
-        end
-
-        it 'can be passed nil' do
-          expect(expect(nil).target).to be_nil
-        end
-
-        it 'passes a valid positive expectation' do
-          expect(5).to eq(5)
-        end
-
-        it 'passes a valid negative expectation' do
-          expect(5).to_not eq(4)
-          expect(5).not_to eq(4)
-        end
-
-        it 'fails an invalid positive expectation' do
-          expect {
-            expect(5).to eq(4)
-          }.to fail_with(/expected: 4.*got: 5/m)
-        end
-
-        it 'fails an invalid negative expectation' do
-          message = /expected 5 not to be a kind of Fixnum/
-          expect {
-            expect(5).to_not be_a(Fixnum)
-          }.to fail_with(message)
-          expect {
-            expect(5).not_to be_a(Fixnum)
-          }.to fail_with(message)
-        end
-
-        it 'does not support operator matchers from #to' do
-          expect {
-            expect(3).to == 3
-          }.to raise_error(ArgumentError)
-        end
-
-        it 'does not support operator matchers from #not_to' do
-          expect {
-            expect(3).not_to == 4
-          }.to raise_error(ArgumentError)
-        end
-      end
-    end
-  end
-end
-