Class: RSpec::Matchers::DSL::Matcher

Inherits:

Object

• Object
• RSpec::Matchers::DSL::Matcher

show all

Extended by:

Macros, RSpec::Matchers::DSL::Macros::Deprecated

Includes:

RSpec::Matchers, Composable, DefaultImplementations, Pretty

Defined in:

lib/rspec/matchers/dsl.rb

Overview

Constant Summary

Instance Attribute Summary (collapse)

• - (Object) actual readonly

  Exposes the value being matched against -- generally the object object wrapped by expect.

• - (Object) expected_as_array readonly

  Returns the expected value as an an array.

• - (Object) rescued_exception readonly

  Exposes the exception raised during the matching by match_unless_raises.

Instance Method Summary (collapse)

• - (Object) expected

  Provides the expected value.

• - (Matcher) initialize(name, declarations, matcher_execution_context, *expected) constructor private

  A new instance of Matcher.

• - (Object) inspect

  Adds the name (rather than a cryptic hex number) so we can identify an instance of the matcher in error messages (e.g. for NoMethodError).

• - (Boolean) respond_to?(method, include_private = false)

  Indicates that this matcher responds to messages from the @matcher_execution_context as well.

• - (Boolean) respond_to_missing?(method, include_private = false)

  Indicates that this matcher responds to messages from the @matcher_execution_context as well.

Methods included from RSpec::Matchers::DSL::Macros::Deprecated

failure_message_for_should, failure_message_for_should_not, match_for_should, match_for_should_not

Methods included from Macros

chain, description, diffable, failure_message, failure_message_when_negated, match, match_unless_raises, match_when_negated, supports_block_expectations

Methods included from Composable

#===, #and, #description_of, enumerable?, #or, surface_descriptions_in, #values_match?

Methods included from Pretty

#name, split_words, #to_sentence, #to_word

Methods included from RSpec::Matchers

alias_matcher, #all, #be, #be_a, #be_a_kind_of, #be_an_instance_of, #be_between, #be_falsey, #be_nil, #be_truthy, #be_within, #change, clear_generated_description, configuration, #contain_exactly, #cover, define_negated_matcher, #end_with, #eq, #eql, #equal, #exist, #expect, generated_description, #have_attributes, #include, #match, #match_array, #output, #raise_error, #respond_to, #satisfy, #start_with, #throw_symbol, #yield_control, #yield_successive_args, #yield_with_args, #yield_with_no_args

Methods included from DefaultImplementations

#description, #diffable?, #expects_call_stack_jump?, #supports_block_expectations?

Methods included from BuiltIn::BaseMatcher::DefaultFailureMessages

#failure_message, #failure_message_when_negated

313
314
315
316
317
318
319
320
321
322
323
324
325

# File 'lib/rspec/matchers/dsl.rb', line 313
def initialize(name, declarations, matcher_execution_context, *expected)
  @name     = name
  @actual   = nil
  @expected_as_array = expected
  @matcher_execution_context = matcher_execution_context
  @chained_method_clauses = []
  class << self
    # See `Macros#define_user_override` above, for an explanation.
    include(@user_method_defs = Module.new)
    self
  end.class_exec(*expected, &declarations)
end

379
380
381
382
383
384
385

# File 'lib/rspec/matchers/dsl.rb', line 379
def method_missing(method, *args, &block)
  if @matcher_execution_context.respond_to?(method)
    @matcher_execution_context.__send__ method, *args, &block
  else
    super(method, *args, &block)
  end
end

306
307
308

# File 'lib/rspec/matchers/dsl.rb', line 306
def actual
  @actual
end

343
344
345

# File 'lib/rspec/matchers/dsl.rb', line 343
def expected_as_array
  @expected_as_array
end

310
311
312

# File 'lib/rspec/matchers/dsl.rb', line 310
def rescued_exception
  @rescued_exception
end

331
332
333
334
335
336
337

# File 'lib/rspec/matchers/dsl.rb', line 331
def expected
  if expected_as_array.size == 1
    expected_as_array[0]
  else
    expected_as_array
  end
end

348
349
350

# File 'lib/rspec/matchers/dsl.rb', line 348
def inspect
  "#<#{self.class.name} #{name}>"
end

362
363
364

# File 'lib/rspec/matchers/dsl.rb', line 362
def respond_to?(method, include_private=false)
  super || @matcher_execution_context.respond_to?(method, include_private)
end

356
357
358

# File 'lib/rspec/matchers/dsl.rb', line 356
def respond_to_missing?(method, include_private=false)
  super || @matcher_execution_context.respond_to?(method, include_private)
end