Class: RSpec::Matchers::BuiltIn::RespondTo Private

Inherits:
BaseMatcher
  • Object
show all
Defined in:
lib/rspec/matchers/built_in/respond_to.rb

Overview

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

Provides the implementation for respond_to. Not intended to be instantiated directly.

Constant Summary

Constants inherited from BaseMatcher

BaseMatcher::UNDEFINED

Instance Method Summary collapse

Methods inherited from BaseMatcher

#diffable?, #expects_call_stack_jump?, #match_unless_raises, #supports_block_expectations?

Methods included from Composable

#===, #and, #description_of, #or, should_enumerate?, surface_descriptions_in, unreadable_io?, #values_match?

Constructor Details

#initialize(*names) ⇒ RespondTo

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.

Returns a new instance of RespondTo.

10
11
12
13
14
15
16
17
 
# File 'lib/rspec/matchers/built_in/respond_to.rb', line 10
def initialize(*names)
  @names = names
  @expected_arity = nil
  @expected_keywords = []
  @ignoring_method_signature_failure = false
  @unlimited_arguments = nil
  @arbitrary_keywords = nil
end

Instance Method Details

#argument ⇒ Object Also known as: arguments

No-op. Intended to be used as syntactic sugar when using with.

Examples:

expect(obj).to respond_to(:message).with(3).arguments
71
72
73
 
# File 'lib/rspec/matchers/built_in/respond_to.rb', line 71
def argument
  self
end

#description ⇒ String

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.

Returns:

  • (String) 
100
101
102
 
# File 'lib/rspec/matchers/built_in/respond_to.rb', line 100
def description
  "respond to #{pp_names}#{with_arity}"
end

#failure_message ⇒ String

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.

Returns:

  • (String) 
88
89
90
 
# File 'lib/rspec/matchers/built_in/respond_to.rb', line 88
def failure_message
  "expected #{actual_formatted} to respond to #{@failing_method_names.map { |name| description_of(name) }.join(', ')}#{with_arity}"
end

#failure_message_when_negated ⇒ String

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.

Returns:

  • (String) 
94
95
96
 
# File 'lib/rspec/matchers/built_in/respond_to.rb', line 94
def failure_message_when_negated
  failure_message.sub(/to respond to/, 'not to respond to')
end

#ignoring_method_signature_failure! ⇒ Object

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 by other matchers to suppress a check

106
107
108
 
# File 'lib/rspec/matchers/built_in/respond_to.rb', line 106
def ignoring_method_signature_failure!
  @ignoring_method_signature_failure = true
end

#with(n) ⇒ Object

Specifies the number of expected arguments.

Examples:

expect(obj).to respond_to(:message).with(3).arguments
24
25
26
27
 
# File 'lib/rspec/matchers/built_in/respond_to.rb', line 24
def with(n)
  @expected_arity = n
  self
end

#with_any_keywords ⇒ Object Also known as: and_any_keywords

Specifies that the method accepts any keyword, i.e. the method has a splatted keyword parameter of the form **kw_args.

Examples:

expect(obj).to respond_to(:message).with_any_keywords
48
49
50
51
 
# File 'lib/rspec/matchers/built_in/respond_to.rb', line 48
def with_any_keywords
  @arbitrary_keywords = true
  self
end

#with_keywords(*keywords) ⇒ Object Also known as: and_keywords

Specifies keyword arguments, if any.

Examples:

expect(obj).to respond_to(:message).with_keywords(:color, :shape)

with an expected number of arguments

expect(obj).to respond_to(:message).with(3).arguments.and_keywords(:color, :shape)
36
37
38
39
 
# File 'lib/rspec/matchers/built_in/respond_to.rb', line 36
def with_keywords(*keywords)
  @expected_keywords = keywords
  self
end

#with_unlimited_arguments ⇒ Object Also known as: and_unlimited_arguments

Specifies that the number of arguments has no upper limit, i.e. the method has a splatted parameter of the form *args.

Examples:

expect(obj).to respond_to(:message).with_unlimited_arguments
60
61
62
63
 
# File 'lib/rspec/matchers/built_in/respond_to.rb', line 60
def with_unlimited_arguments
  @unlimited_arguments = true
  self
end