Class: RSpec::Matchers::OperatorMatcher

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

Direct Known Subclasses

BuiltIn::NegativeOperatorMatcher, BuiltIn::PositiveOperatorMatcher

Class Method Summary (collapse)

Instance Method Summary (collapse)

Constructor Details

- (OperatorMatcher) initialize(actual)

A new instance of OperatorMatcher

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

Class Method Details

+ (Object) get(klass, operator) 

18
19
20
21
22
23
24
25
 
# File 'lib/rspec/matchers/operator_matcher.rb', line 18
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) 

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

+ (Object) registry 

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

+ (Object) unregister(klass, operator) 

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

+ (Object) use_custom_matcher_or_delegate(operator) 

32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
 
# File 'lib/rspec/matchers/operator_matcher.rb', line 32
def self.use_custom_matcher_or_delegate(operator)
  define_method(operator) do |expected|
    if uses_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 

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

- (Object) fail_with_message(message) 

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

- (Boolean) uses_generic_implementation_of?(op)

Returns:

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