Class: RSpec::Matchers::BuiltIn::Compound::NestedEvaluator Private

Inherits:
Object
  • Object
show all
Defined in:
lib/rspec/matchers/built_in/compound.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.

Normally, we evaluate the matching sequentially. For an expression like expect(x).to foo.and bar, this becomes:

expect(x).to foo expect(x).to bar

For block expectations, we need to nest them instead, so that expect { x }.to foo.and bar becomes:

expect { expect { x }.to foo }.to bar

This is necessary so that the expect block is only executed once.

Instance Method Summary collapse

Constructor Details

#initialize(actual, matcher_1, matcher_2) ⇒ NestedEvaluator

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 NestedEvaluator.


157
158
159
160
161
162
163
164
165
166
167
168
# File 'lib/rspec/matchers/built_in/compound.rb', line 157

def initialize(actual, matcher_1, matcher_2)
  @actual        = actual
  @matcher_1     = matcher_1
  @matcher_2     = matcher_2
  @match_results = {}

  inner, outer = order_block_matchers

  @match_results[outer] = outer.matches?(Proc.new do |*args|
    @match_results[inner] = inner.matches?(inner_matcher_block(args))
  end)
end

Instance Method Details

#matcher_matches?(matcher) ⇒ Boolean

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:

  • (Boolean)

170
171
172
173
174
175
176
177
# File 'lib/rspec/matchers/built_in/compound.rb', line 170

def matcher_matches?(matcher)
  @match_results.fetch(matcher) do
    raise ArgumentError, "Your #{matcher.description} has no match " \
     "results, this can occur when an unexpected call stack or " \
     "local jump occurs. Prehaps one of your matchers needs to " \
     "declare `expects_call_stack_jump?` as `true`?"
  end
end