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, #end_with, #eq, #eql, #equal, #exist, #expect, generated_description, #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?, #failure_message, #failure_message_when_negated, #supports_block_expectations?

302
303
304
305
306
307
308
309
310
311
312
313

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

367
368
369
370
371
372
373

# File 'lib/rspec/matchers/dsl.rb', line 367
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

295
296
297

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

331
332
333

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

299
300
301

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

319
320
321
322
323
324
325

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

336
337
338

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

350
351
352

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

344
345
346

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