Class: RSpec::SleepingKingStudios::Matchers::Core::HaveReaderMatcher

Inherits:
BaseMatcher
  • Object
show all
Includes:
Shared::MatchProperty
Defined in:
lib/rspec/sleeping_king_studios/matchers/core/have_reader_matcher.rb

Overview

Matcher for testing whether an object has a specific property reader, e.g. responds to :property.

Since:

  • 1.0.0

Constant Summary

Constants included from Description

Description::DEFAULT_EXPECTED_ITEMS

Instance Attribute Summary

Attributes inherited from BaseMatcher

#actual

Instance Method Summary collapse

Constructor Details

#initialize(expected) ⇒ HaveReaderMatcher

Returns a new instance of HaveReaderMatcher.

Parameters:

  • expected (String, Symbol) —

    The property to check for on the actual object.

Since:

  • 1.0.0



23
24
25
 
# File 'lib/rspec/sleeping_king_studios/matchers/core/have_reader_matcher.rb', line 23

def initialize expected
  @expected = expected.intern
end

Instance Method Details

#description ⇒ Object

Since:

  • 1.0.0



16
17
18
19
 
# File 'lib/rspec/sleeping_king_studios/matchers/core/have_reader_matcher.rb', line 16

def description
  value_message = value_to_string
  "have reader :#{@expected}#{@value_set ? " with value #{value_message}" : ''}"
end

#does_not_match?(actual) ⇒ Boolean

Inverse of #matches? method.

Parameters:

  • actual (Object) —

    the object to test against the matcher

Returns:

  • (Boolean) —

    false if the object matches, otherwise true

See Also:

Since:

  • 1.0.0



28
29
30
31
32
 
# File 'lib/rspec/sleeping_king_studios/matchers/core/have_reader_matcher.rb', line 28

def does_not_match? actual
  super

  matches_reader?(:none?)
end

#failure_message ⇒ Object

Message for when the object does not match, but was expected to. Make sure to always call #matches? first to set up the matcher state.

Since:

  • 1.0.0



62
63
64
65
66
67
68
69
70
71
72
73
 
# File 'lib/rspec/sleeping_king_studios/matchers/core/have_reader_matcher.rb', line 62

def failure_message
  message = "expected #{@actual.inspect} to respond to :#{@expected}"
  message << " and return #{value_to_string}" if @value_set

  if !@matches_reader
    message << ", but did not respond to :#{@expected}"
  elsif !@matches_reader_value
    message << ", but returned #{@actual.send(@expected).inspect}"
  end # if

  message
end

#failure_message_when_negated ⇒ Object

Message for when the object matches, but was expected not to. Make sure to always call #matches? first to set up the matcher state.

Since:

  • 1.0.0



76
77
78
79
80
81
82
83
84
85
86
 
# File 'lib/rspec/sleeping_king_studios/matchers/core/have_reader_matcher.rb', line 76

def failure_message_when_negated
  message = "expected #{@actual.inspect} not to respond to :#{@expected}"
  message << " and return #{value_to_string}" if @value_set

  errors = []
  errors << "responded to :#{@expected}" if @matches_reader
  errors << "returned #{@actual.send(@expected).inspect}" if @matches_reader_value

  message << ", but #{errors.join(" and ")}"
  message
end

#matches?(actual) ⇒ Boolean

Checks if the object responds to #expected. Additionally, if a value expectation is set, compares the value of #expected to the specified value.

Parameters:

  • actual (Object) —

    The object to check.

Returns:

  • (Boolean) —

    true If the object responds to #expected and matches the value expectation (if any); otherwise false.

Since:

  • 1.0.0



42
43
44
45
46
 
# File 'lib/rspec/sleeping_king_studios/matchers/core/have_reader_matcher.rb', line 42

def matches? actual
  super

  matches_reader?(:all?)
end

#with(value) ⇒ HaveReaderMatcher Also known as: with_value

Sets a value expectation. The matcher will compare the value from #property with the specified value.

Parameters:

  • value (Object) —

    The value to compare.

Returns:

Since:

  • 1.0.0



54
55
56
57
58
 
# File 'lib/rspec/sleeping_king_studios/matchers/core/have_reader_matcher.rb', line 54

def with value
  @value = value
  @value_set = true
  self
end