Parent

Class/Module Index [+]

Quicksearch

RSpec::Matchers::DSL::Matcher

The class used for custom matchers. The block passed to `RSpec::Matchers.define` will be evaluated in the context of the singleton class of an instance, and will have the {RSpec::Matchers::DSL::Macros Macros} methods available.

Attributes

actual[R]

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

expected_as_array[R]

Returns the expected value as an an array. This exists primarily to aid in upgrading from RSpec 2.x, since in RSpec 2, `expected` always returned an array. @see expected

rescued_exception[R]

Exposes the exception raised during the matching by `match_unless_raises`. Could be useful to extract details for a failure message.

Public Class Methods

new(name, declarations, matcher_execution_context, *expected) click to toggle source

@api private

# 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

Public Instance Methods

expected() click to toggle source

Provides the expected value. This will return an array if multiple arguments were passed to the matcher; otherwise it will return a single value. @see expected_as_array

# 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
inspect() click to toggle source

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`)

# File lib/rspec/matchers/dsl.rb, line 336
def inspect
  "#<#{self.class.name} #{name}>"
end
respond_to?(method, include_private=false) click to toggle source

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

# 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
respond_to_missing?(method, include_private=false) click to toggle source

Indicates that this matcher responds to messages from the `@matcher_execution_context` as well. Also, supports getting a method object for such methods.

# 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

[Validate]

Generated with the Darkfish Rdoc Generator 2.