123456789_123456789_123456789_123456789_123456789_

Class: RSpec::Matchers::BuiltIn::ChangeToValue Private

Do not use. This class is for internal use only.

Overview

Used to specify a change to a specific value (and, optionally, from a specific value).

Constant Summary

BaseMatcher - Inherited

UNDEFINED

SpecificValuesChange - Inherited

MATCH_ANYTHING

Class Method Summary

SpecificValuesChange - Inherited

.new

BaseMatcher - Inherited

.matcher_name, .new,
.underscore

Borrowed from ActiveSupport.

Instance Attribute Summary

SpecificValuesChange - Inherited

#supports_block_expectations?, #supports_value_expectations?, #matches_after?

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

SpecificValuesChange - Inherited

#description, #failure_message, #matches?, #after_value_failure, #before_value_failure, #did_change_failure, #did_not_change_failure, #not_given_a_block_failure, #perform_change

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 Method Details

#change_description (private)

[ GitHub ] 

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/change.rb', line 333



def change_description
  "to #{description_of @expected_after}#{@description_suffix}"
end


  








  

    #does_not_match?(_event_proc)  ⇒ Boolean 
  



  

    
  





  
Raises:


    
  
  • 
    (NotImplementedError)
  
    • 





  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/change.rb', line 326



def does_not_match?(_event_proc)
  raise NotImplementedError, "`expect { }.not_to change { }.to()` " \
    "is not supported"
end


  








  

    #from(value)  
  



  

    

Specifies the original value.


  





  


  [ GitHub ]


  

  


# File 'rspec-expectations/lib/rspec/matchers/built_in/change.rb', line 319



def from(value)
  @expected_before    = value
  @description_suffix = " from #{description_of value}"
  self
end