tracks/vendor/plugins/rspec/lib/spec/matchers/equal.rb

module Spec
  module Matchers
  
    class Equal #:nodoc:
      def initialize(expected)
        @expected = expected
      end
  
      def matches?(given)
        @given = given
        @given.equal?(@expected)
      end

      def failure_message
        return "expected #{@expected.inspect}, got #{@given.inspect} (using .equal?)", @expected, @given
      end

      def negative_failure_message
        return "expected #{@given.inspect} not to equal #{@expected.inspect} (using .equal?)", @expected, @given
      end
      
      def description
        "equal #{@expected.inspect}"
      end
    end
    
    # :call-seq:
    #   should equal(expected)
    #   should_not equal(expected)
    #
    # Passes if given and expected are the same object (object identity).
    #
    # See http://www.ruby-doc.org/core/classes/Object.html#M001057 for more information about equality in Ruby.
    #
    # == Examples
    #
    #   5.should equal(5) #Fixnums are equal
    #   "5".should_not equal("5") #Strings that look the same are not the same object
    def equal(expected)
      Matchers::Equal.new(expected)
    end
  end
end