Module: RSpec::Expectations::ExpectationHelper Private

Do not use. This module is for internal use only.

Relationships & Source Files
Defined in:	rspec-expectations/lib/rspec/expectations/handler.rb

Class Method Summary

.check_message(msg) Internal use only
.handle_failure(matcher, message, failure_message_method) Internal use only
.modern_matcher_from(matcher) Internal use only

Returns an RSpec-3+ compatible matcher, wrapping a legacy one in an adapter if necessary.
.with_matcher(handler, matcher, message) Internal use only

Class Method Details

.check_message(msg)

[ GitHub ]

# File 'rspec-expectations/lib/rspec/expectations/handler.rb', line 5


def self.check_message(msg)
  unless msg.nil? || msg.respond_to?(:to_str) || msg.respond_to?(:call)
    ::Kernel.warn [
      "WARNING: ignoring the provided expectation message argument (",
      msg.inspect,
      ") since it is not a string or a proc."
    ].join
  end
end

.handle_failure(matcher, message, failure_message_method)

[ GitHub ]

# File 'rspec-expectations/lib/rspec/expectations/handler.rb', line 33


def self.handle_failure(matcher, message, failure_message_method)
  message = message.call if message.respond_to?(:call)
  message ||= matcher.__send__(failure_message_method)

  if matcher.respond_to?(:diffable?) && matcher.diffable?
    ::RSpec::Expectations.fail_with message, matcher.expected, matcher.actual
  else
    ::RSpec::Expectations.fail_with message
  end
end

.modern_matcher_from(matcher)

Returns an RSpec-3+ compatible matcher, wrapping a legacy one in an adapter if necessary.

[ GitHub ]

# File 'rspec-expectations/lib/rspec/expectations/handler.rb', line 19


def self.modern_matcher_from(matcher)
  LegacyMatcherAdapter::RSpec2.wrap(matcher) ||
  LegacyMatcherAdapter::RSpec1.wrap(matcher) || matcher
end

.with_matcher(handler, matcher, message)

[ GitHub ]

# File 'rspec-expectations/lib/rspec/expectations/handler.rb', line 24


def self.with_matcher(handler, matcher, message)
  check_message(message)
  matcher = modern_matcher_from(matcher)
  yield matcher
ensure
  ::RSpec::Matchers.last_expectation_handler = handler
  ::RSpec::Matchers.last_matcher = matcher
end