Class: RSpec::Matchers::BuiltIn::OperatorMatcher

Inherits:
Object
  • Object
show all
Defined in:
lib/rspec/matchers/operator_matcher.rb

Direct Known Subclasses

NegativeOperatorMatcher, PositiveOperatorMatcher

Class Method Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (OperatorMatcher) initialize(actual)

A new instance of OperatorMatcher

29
30
31
 
# File 'lib/rspec/matchers/operator_matcher.rb', line 29
def initialize(actual)
  @actual = actual
end

Class Method Details

+ (Object) get(klass, operator) 

19
20
21
22
23
24
25
26
 
# File 'lib/rspec/matchers/operator_matcher.rb', line 19
def get(klass, operator)
  klass.ancestors.each { |ancestor|
    matcher = registry[ancestor] && registry[ancestor][operator]
    return matcher if matcher
  }
  nil
end

+ (Object) register(klass, operator, matcher) 

10
11
12
13
 
# File 'lib/rspec/matchers/operator_matcher.rb', line 10
def register(klass, operator, matcher)
  registry[klass] ||= {}
  registry[klass][operator] = matcher
end

+ (Object) registry 

6
7
8
 
# File 'lib/rspec/matchers/operator_matcher.rb', line 6
def registry
  @registry ||= {}
end

+ (Object) unregister(klass, operator) 

15
16
17
 
# File 'lib/rspec/matchers/operator_matcher.rb', line 15
def unregister(klass, operator)
  registry[klass] && registry[klass].delete(operator)
end

+ (Object) use_custom_matcher_or_delegate(operator) 

33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
 
# File 'lib/rspec/matchers/operator_matcher.rb', line 33
def self.use_custom_matcher_or_delegate(operator)
  define_method(operator) do |expected|
    if !has_non_generic_implementation_of?(operator) && matcher = OperatorMatcher.get(@actual.class, operator)
      @actual.__send__(::RSpec::Matchers.last_should, matcher.new(expected))
    else
      eval_match(@actual, operator, expected)
    end
  end
  negative_operator = operator.sub(/^=/, '!')
  if negative_operator != operator && respond_to?(negative_operator)
    define_method(negative_operator) do |expected|
      opposite_should = ::RSpec::Matchers.last_should == :should ? :should_not : :should
      raise "RSpec does not support `#{::RSpec::Matchers.last_should} #{negative_operator} expected`.  " +
        "Use `#{opposite_should} #{operator} expected` instead."
    end
  end
end

Instance Method Details

- (Object) description 

60
61
62
 
# File 'lib/rspec/matchers/operator_matcher.rb', line 60
def description
  "#{@operator} #{@expected.inspect}"
end

- (Object) fail_with_message(message) 

56
57
58
 
# File 'lib/rspec/matchers/operator_matcher.rb', line 56
def fail_with_message(message)
  RSpec::Expectations.fail_with(message, @expected, @actual)
end

- (Boolean) has_non_generic_implementation_of?(op)

Returns:

  • (Boolean) 
67
68
69
70
71
 
# File 'lib/rspec/matchers/operator_matcher.rb', line 67
def has_non_generic_implementation_of?(op)
  Expectations.method_handle_for(@actual, op).owner != ::Kernel
rescue NameError
  false
end