Module: RSpec::Matchers::DSL::DefaultImplementations

Included in:
Matcher
Defined in:
lib/rspec/matchers/dsl.rb

Overview

Defines default implementations of the matcher protocol methods for custom matchers. You can override any of these using the Macros methods from within an RSpec::Matchers.define block.

Instance Method Summary (collapse)

Instance Method Details

- (Object) description

The default description.



255
256
257
# File 'lib/rspec/matchers/dsl.rb', line 255

def description
  "#{name_to_sentence}#{to_sentence expected}#{chained_method_clause_sentences}"
end

- (Boolean) diffable?

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Used internally by objects returns by should and should_not.

Returns:

  • (Boolean)


250
251
252
# File 'lib/rspec/matchers/dsl.rb', line 250

def diffable?
  false
end

- (Boolean) expects_call_stack_jump?

Most matchers do not expect call stack jumps.

Returns:

  • (Boolean)


276
277
278
# File 'lib/rspec/matchers/dsl.rb', line 276

def expects_call_stack_jump?
  false
end

- (Object) failure_message

The default failure message for positive expectations.



260
261
262
# File 'lib/rspec/matchers/dsl.rb', line 260

def failure_message
  "expected #{actual.inspect} to #{description}"
end

- (Object) failure_message_when_negated

The default failure message for negative expectations.



265
266
267
# File 'lib/rspec/matchers/dsl.rb', line 265

def failure_message_when_negated
  "expected #{actual.inspect} not to #{description}"
end

- (Boolean) supports_block_expectations?

Matchers do not support block expectations by default. You must opt-in.

Returns:

  • (Boolean)


271
272
273
# File 'lib/rspec/matchers/dsl.rb', line 271

def supports_block_expectations?
  false
end