Class: RSpec::Matchers::BuiltIn::StartAndEndWith Private

Inherits:
BaseMatcher
  • Object
show all
Defined in:
lib/rspec/matchers/built_in/start_and_end_with.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

Base class for the end_with and start_with matchers. Not intended to be instantiated directly.

Direct Known Subclasses

EndWith, StartWith

Constant Summary

Constant Summary

Constants inherited from BaseMatcher

BaseMatcher::UNDEFINED

Instance Method Summary (collapse)

Methods inherited from BaseMatcher

#diffable?, #failure_message_when_negated, #match_unless_raises, #matches?, #supports_block_expectations?

Methods included from Composable

#===, #and, #description_of, enumerable?, #or, surface_descriptions_in, #values_match?

Methods included from Pretty

#name, split_words, #to_sentence, #to_word

Constructor Details

- (StartAndEndWith) initialize(*expected)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of StartAndEndWith

8
9
10
11
# File 'lib/rspec/matchers/built_in/start_and_end_with.rb', line 8
def initialize(*expected)
  @actual_does_not_have_ordered_elements = false
  @expected = expected.length == 1 ? expected.first : expected
end

Instance Method Details

- (String) description

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns:

  • (String)
27
28
29
30
# File 'lib/rspec/matchers/built_in/start_and_end_with.rb', line 27
def description
  return super unless Hash === expected
  "#{name_to_sentence} #{surface_descriptions_in(expected).inspect}"
end

- (String) failure_message

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns:

  • (String)
15
16
17
18
19
20
21
22
23
# File 'lib/rspec/matchers/built_in/start_and_end_with.rb', line 15
def failure_message
  super.tap do |msg|
    if @actual_does_not_have_ordered_elements
      msg << ", but it does not have ordered elements"
    elsif !actual.respond_to?(:[])
      msg << ", but it cannot be indexed using #[]"
    end
  end
end