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.

143
144
145
146
147
148
149
150
151
152
153
154
# File 'lib/rspec/matchers/built_in/compound.rb', line 143
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)
156
157
158
159
160
161
162
163
# File 'lib/rspec/matchers/built_in/compound.rb', line 156
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