123456789_123456789_123456789_123456789_123456789_

Class: RSpec::Matchers::BuiltIn::DynamicPredicate Private

Do not use. This class is for internal use only.
Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Subclasses:
RSpec::Matchers::BuiltIn::BePredicate, RSpec::Matchers::BuiltIn::Has
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, BaseMatcher
Instance Chain:
self, BeHelpers, BaseMatcher, BaseMatcher::DefaultFailureMessages, BaseMatcher::StringEncodingFormatting, BaseMatcher::HashFormatting, ::RSpec::Matchers::Composable
Inherits: RSpec::Matchers::BuiltIn::BaseMatcher
Defined in: rspec-expectations/lib/rspec/matchers/built_in/has.rb

Overview

Provides the implementation for dynamic predicate matchers. Not intended to be inherited directly.

Constant Summary

BaseMatcher - Inherited

UNDEFINED

Class Method Summary

BaseMatcher - Inherited

.matcher_name, .new,
.underscore

Borrowed from ActiveSupport.

Instance Attribute Summary

BaseMatcher - Inherited

#actual,
#diffable?

::RSpec::Matchers are not diffable by default.
#expected, #expects_call_stack_jump?, #matcher_name, #matcher_name=, #rescued_exception,
#supports_block_expectations?

Most matchers are value matchers (i.e. meant to work with ‘expect(value)`) rather than block matchers (i.e. meant to work with `expect { }`), so this defaults to false.
#supports_value_expectations?

BaseMatcher::StringEncodingFormatting - Included

#string_encoding_differs?

Instance Method Summary

BeHelpers - Included

#args_to_s, #args_to_sentence, #expected_to_sentence, #inspected_args, #parenthesize

BaseMatcher - Inherited

#actual_formatted,
#description

Generates a description using ::RSpec::Matchers::EnglishPhrasing.
#expected_formatted,
#match_unless_raises

Used to wrap a block of code that will indicate failure by raising one of the named exceptions.
#matches?

Indicates if the match is successful.
#assert_ivars,
#present_ivars

:nocov:

BaseMatcher::DefaultFailureMessages - Included

#failure_message

Provides a good generic failure message.
#failure_message_when_negated

Provides a good generic negative failure message.

BaseMatcher::StringEncodingFormatting - Included

#format_encoding

Formats a String’s encoding as a human readable string.

BaseMatcher::HashFormatting - Included

#improve_hash_formatting

‘{ :a => 5, :b => 2 }.inspect` produces:

::RSpec::Matchers::Composable - Included

#&

Alias for Composable#and.
#===

Delegates to ‘#matches?`.
#and

Creates a compound ‘and` expectation.
#description_of

Returns the description of the given object in a way that is aware of composed matchers.
#or

Creates a compound ‘or` expectation.
#values_match?

This provides a generic way to fuzzy-match an expected value against an actual value.
#|

Alias for Composable#or.
#should_enumerate?

We should enumerate arrays as long as they are not recursive.
#surface_descriptions_in

Transforms the given data structure (typically a hash or array) into a new data structure that, when ‘#inspect` is called on it, will provide descriptions of any contained matchers rather than the normal #inspect output.
#unreadable_io?,
#with_matchers_cloned

Historically, a single matcher instance was only checked against a single value.

Instance Attribute Details

#predicate_accessible? ⇒ Boolean (readonly, private)

[ GitHub ] 

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 49



def predicate_accessible?
  @actual.respond_to? predicate
end


  








  

    #private_predicate?  ⇒ Boolean  (readonly, private)
  



  

    

:nocov:



See additional method definition at line 56.


  





  


  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 61



def private_predicate?
  @actual.private_methods.include? predicate.to_s
end


  







Instance Method Details



  

    #description  ⇒ String 
  



  

    
  





  


  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 43



def description
  "#{method_description}#{args_to_sentence}"
end


  








  

    #does_not_match?(actual, &block)  ⇒ Boolean 
  



  

    
  





  


  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 23



def does_not_match?(actual, &block)
  @actual = actual
  @block ||= block
  predicate_accessible? && predicate_matches?(false)
end


  








  

    #expectation_of(value)   (private)
  

  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 99



def expectation_of(value)
  if RSpec::Expectations.configuration.strict_predicate_matchers?
    "return #{value}"
  elsif value
    "be truthy"
  else
    "be falsey"
  end
end


  








  

    #failure_message  ⇒ String 
  



  

    
  





  


  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 31



def failure_message
  failure_message_expecting(true)
end


  








  

    #failure_message_expecting(value)   (private)
  

  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 94



def failure_message_expecting(value)
  validity_message ||
    "expected `#{actual_formatted}.#{predicate}#{args_to_s}` to #{expectation_of value}, got #{description_of @predicate_result}"
end


  








  

    #failure_message_when_negated  ⇒ String 
  



  

    
  





  


  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 37



def failure_message_when_negated
  failure_message_expecting(false)
end


  








  

    #failure_to_respond_explanation   (private)
  

  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 115



def failure_to_respond_explanation
  if private_predicate?
    " but `#{predicate}` is a private method"
  end
end


  








  

    #matches?(actual, &block)  ⇒ Boolean 
  



  

    
  





  


  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 16



def matches?(actual, &block)
  @actual = actual
  @block ||= block
  predicate_accessible? && predicate_matches?
end


  








  

    #method_description   (private)
  

  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 90



def method_description
  EnglishPhrasing.split_words(@method_name)
end


  








  

    #predicate_matches?(value = true)  ⇒ Boolean  (private)
  



  

    
  





  


  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 74



def predicate_matches?(value=true)
  if RSpec::Expectations.configuration.strict_predicate_matchers?
    value == predicate_result
  else
    value == !!predicate_result
  end
end


  








  

    #predicate_method_name   (private)
  

  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 70



def predicate_method_name
  predicate
end


  








  

    #predicate_result   (private)
  

  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 66



def predicate_result
  @predicate_result = actual.__send__(predicate_method_name, *@args, &@block)
end


  








  

    #root   (private)
  

  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 82



def root
  # On 1.9, there appears to be a bug where String#match can return `false`
  # rather than the match data object. Changing to Regex#match appears to
  # work around this bug. For an example of this bug, see:
  # https://travis-ci.org/rspec/rspec-expectations/jobs/27549635
  self.class::REGEX.match(@method_name.to_s).captures.first
end


  








  

    #validity_message   (private)
  

  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/has.rb', line 109



def validity_message
  return nil if predicate_accessible?

  "expected #{actual_formatted} to respond to `#{predicate}`#{failure_to_respond_explanation}"
end