rspec-sleeping_king_studios 2.0.0.beta.0 → 2.0.0.beta.1

data/lib/rspec/sleeping_king_studios/examples/property_examples.rb

@@ -0,0 +1,58 @@
+# lib/rspec/sleeping_king_studios/examples/property_examples.rb
+
+require 'rspec/sleeping_king_studios/examples'
+require 'rspec/sleeping_king_studios/examples/shared_example_group'
+require 'rspec/sleeping_king_studios/matchers/core/have_reader'
+require 'rspec/sleeping_king_studios/matchers/core/have_writer'
+require 'sleeping_king_studios/tools/object_tools'
+
+module RSpec::SleepingKingStudios::Examples::PropertyExamples
+  extend RSpec::SleepingKingStudios::Examples::SharedExampleGroup
+
+  UNDEFINED_PROPERTY_EXPECTATION = Object.new.freeze
+
+  shared_examples 'has reader' do |property, expected_value = UNDEFINED_PROPERTY_EXPECTATION|
+    it "has reader :#{property}" do
+      object = defined?(instance) ? instance : subject
+
+      expect(object).to have_reader(property)
+
+      next if expected_value == UNDEFINED_PROPERTY_EXPECTATION
+
+      actual_value = instance.send property
+
+      if expected_value.is_a?(Proc)
+        args = [self, expected_value]
+        args.push actual_value unless 0 == expected_value.arity
+
+        expected_value = SleepingKingStudios::Tools::ObjectTools.apply *args
+      end # if
+
+      case expected_value
+      when ->(obj) { obj.respond_to?(:matches?) }
+        expect(actual_value).to expected_value
+      when true, false
+        expected_value
+      else
+        expect(actual_value).to be == expected_value
+      end # case
+    end # it
+  end # shared_examples
+  alias_shared_examples 'should have reader', 'has reader'
+
+  shared_examples 'has writer' do |property|
+    it "has writer :#{property}=" do
+      object = defined?(instance) ? instance : subject
+
+      expect(object).to have_writer(property)
+    end # it
+  end # shared_examples
+  alias_shared_examples 'should have writer', 'has writer'
+
+  shared_examples 'has property' do |property, expected_value = UNDEFINED_PROPERTY_EXPECTATION|
+    include_examples 'has reader', property, expected_value
+
+    include_examples 'has writer', property
+  end # shared_examples
+  alias_shared_examples 'should have property', 'has property'
+end # module

data/lib/rspec/sleeping_king_studios/examples/rspec_matcher_examples.rb

@@ -0,0 +1,105 @@
+# lib/rspec/sleeping_king_studios/examples/rspec_matcher_examples.rb
+
+require 'rspec/sleeping_king_studios/examples'
+require 'rspec/sleeping_king_studios/examples/shared_example_group'
+require 'rspec/sleeping_king_studios/matchers/base_matcher'
+
+module RSpec::SleepingKingStudios::Examples::RSpecMatcherExamples
+  extend RSpec::SleepingKingStudios::Examples::SharedExampleGroup
+
+  shared_examples 'passes with a positive expectation' do
+    let(:matcher_being_examined) { defined?(instance) ? instance : subject }
+
+    it 'passes with a positive expectation' do
+      expect(matcher_being_examined.matches? actual).to be true
+    end # it
+  end # shared_examples
+  alias_shared_examples 'should pass with a positive expectation', 'passes with a positive expectation'
+
+  shared_examples 'fails with a positive expectation' do
+    let(:matcher_being_examined) { defined?(instance) ? instance : subject }
+
+    it 'fails with a positive expectation' do
+      expect(matcher_being_examined.matches? actual).to be false
+    end # it
+
+    it 'has a failure message with a positive expectation' do
+      if defined?(failure_message)
+        matcher_being_examined.matches?(actual)
+
+        expected = failure_message.is_a?(String) ?
+          Regexp.new(Regexp.escape(failure_message)) :
+          failure_message
+
+        expect(matcher_being_examined.failure_message).to match expected
+      else
+        message = <<-MESSAGE
+          expected to match #{matcher_being_examined.class}#failure_message, but the expected
+          value was undefined. Define a failure message using
+          let(:failure_message) or set
+          config.handle_missing_failure_message_with to :ignore or :pending.
+        MESSAGE
+        message = message.split("\n").map(&:strip).join(' ')
+        case RSpec.configuration.sleeping_king_studios.examples.handle_missing_failure_message_with
+        when :pending
+          skip message
+        when :exception
+          raise StandardError.new message
+        end # case
+      end # if
+    end # it
+  end # shared_examples
+  alias_shared_examples 'should fail with a positive expectation', 'fails with a positive expectation'
+
+  shared_examples 'passes with a negative expectation' do
+    let(:matcher_being_examined) { defined?(instance) ? instance : subject }
+
+    it 'passes with a negative expectation' do
+      if matcher_being_examined.respond_to?(:does_not_match?)
+        expect(matcher_being_examined.does_not_match? actual).to be true
+      else
+        expect(matcher_being_examined.matches? actual).to be false
+      end # if-else
+    end # it
+  end # shared_examples
+  alias_shared_examples 'should pass with a negative expectation', 'passes with a negative expectation'
+
+  shared_examples 'fails with a negative expectation' do
+    let(:matcher_being_examined) { defined?(instance) ? instance : subject }
+
+    it 'fails with a negative expectation' do
+      if matcher_being_examined.respond_to?(:does_not_match?)
+        expect(matcher_being_examined.does_not_match? actual).to be false
+      else
+        expect(matcher_being_examined.matches? actual).to be true
+      end # if-else
+    end # it
+
+    it 'has a failure message with a negative expectation' do
+      if defined?(failure_message_when_negated)
+        matcher_being_examined.respond_to?(:does_not_match?) ? matcher_being_examined.does_not_match?(actual) : matcher_being_examined.matches?(actual)
+
+        expected = failure_message_when_negated.is_a?(String) ?
+          Regexp.new(Regexp.escape(failure_message_when_negated)) :
+          failure_message_when_negated
+
+        expect(matcher_being_examined.failure_message_when_negated).to match expected
+      else
+        message = <<-MESSAGE
+          expected to match #{matcher_being_examined.class}#failure_message_when_negated, but
+          the expected value was undefined. Define a failure message using
+          let(:failure_message_when_negated) or set
+          config.handle_missing_failure_message_with to :ignore or :pending.
+        MESSAGE
+        message = message.split("\n").map(&:strip).join(' ')
+        case RSpec.configuration.sleeping_king_studios.examples.handle_missing_failure_message_with
+        when :pending
+          skip message
+        when :exception
+          raise StandardError.new message
+        end # case
+      end # if
+    end # it
+  end # shared_examples
+  alias_shared_examples 'should fail with a negative expectation', 'fails with a negative expectation'
+end # module

data/lib/rspec/sleeping_king_studios/examples/shared_example_group.rb

@@ -0,0 +1,62 @@
+# lib/rspec/sleeping_king_studios/examples/shared_example_group.rb
+
+require 'rspec/sleeping_king_studios/examples'
+
+module RSpec::SleepingKingStudios::Examples
+  module SharedExampleGroup
+    # Aliases a defined shared example group, allowing it to be accessed using
+    # a new name. The example group must be defined in the current context
+    # using `shared_examples`. The aliases must be defined before including the
+    # module into an example group, or they will not be available in the
+    # example group.
+    #
+    # @param [String] new_name The new name to alias the shared example group
+    #   as.
+    # @param [String] old_name The name under which the shared example group is
+    #   currently defined.
+    def alias_shared_examples new_name, old_name
+      proc = shared_example_groups[self][old_name]
+
+      self.shared_examples new_name, &proc
+    end # method alias_shared_examples
+
+    # @api private
+    def included other
+      merge_shared_example_groups other
+    end # method included
+
+    # @overload shared_examples(name, &block)
+    #   @param [String] name Identifer to use when looking up this shared group.
+    #   @param block Used to create the shared example group definition.
+    # @overload shared_examples(name, metadata, &block)
+    #   @param [String] name Identifer to use when looking up this shared group.
+    #   @param metadata [Array<Symbol>, Hash] Metadata to attach to this group;
+    #     any example group with matching metadata will automatically include
+    #     this shared example group.
+    #   @param block Used to create the shared example group definition.
+    #
+    # Defines a shared example group within the context of the current module.
+    # Unlike a top-level example group defined using RSpec#shared_examples,
+    # these examples are not globally available, and must be mixed into an
+    # example group by including the module. The shared examples must be
+    # defined before including the module, or they will not be available in the
+    # example group.
+    def shared_examples name, *metadata_args, &block
+      RSpec.world.shared_example_group_registry.add(self, name, *metadata_args, &block)
+    end # method shared_examples
+
+    private
+
+    # @api private
+    def merge_shared_example_groups other
+      shared_example_groups[self].each do |name, proc|
+        RSpec.world.shared_example_group_registry.add(other, name, &proc)
+      end # each
+    end # method merge_shared_example_groups
+
+    # @api private
+    def shared_example_groups
+      RSpec.world.shared_example_group_registry.send :shared_example_groups
+    end # method shared_example_groups
+  end # module
+end # module

data/lib/rspec/sleeping_king_studios/examples.rb

@@ -0,0 +1,8 @@
+# lib/rspec/sleeping_king_studios/examples.rb
+
+require 'rspec/sleeping_king_studios'
+
+module RSpec::SleepingKingStudios
+  # Pregenerated example groups for use with RSpec.
+  module Examples; end
+end # module

data/lib/rspec/sleeping_king_studios/matchers/active_model/all.rb

@@ -0,0 +1,5 @@
+# lib/rspec/sleeping_king_studios/matchers/active_model/all.rb
+
+Dir[File.join File.dirname(__FILE__), '*.rb'].each do |file|
+  require file
+end # end each

data/lib/rspec/sleeping_king_studios/matchers/active_model/have_errors/error_expectation.rb

@@ -1,6 +1,5 @@
 # lib/rspec/sleeping_king_studios/matchers/active_model/have_errors/error_expectation.rb
 
-require 'rspec/sleeping_king_studios/matchers/base_matcher'
 require 'rspec/sleeping_king_studios/matchers/active_model/have_errors/message_expectation'
 
 module RSpec::SleepingKingStudios::Matchers::ActiveModel::HaveErrors

data/lib/rspec/sleeping_king_studios/matchers/active_model/have_errors/message_expectation.rb

@@ -1,7 +1,6 @@
 # lib/rspec/sleeping_king_studios/matchers/active_model/have_errors/message_expectation.rb
 
-require 'rspec/sleeping_king_studios/matchers/base_matcher'
-require 'rspec/sleeping_king_studios/matchers/active_model/have_errors/require'
+require 'rspec/sleeping_king_studios/matchers/active_model'
 
 module RSpec::SleepingKingStudios::Matchers::ActiveModel::HaveErrors
   # Stores an expectation of receiving a specified error message.

data/lib/rspec/sleeping_king_studios/matchers/active_model/have_errors.rb

@@ -1,15 +1,19 @@
 # lib/rspec/sleeping_king_studios/matchers/active_model/have_errors.rb
 
 require 'rspec/sleeping_king_studios/matchers/base_matcher'
-require 'rspec/sleeping_king_studios/matchers/active_model/require'
+require 'rspec/sleeping_king_studios/matchers/active_model'
 require 'rspec/sleeping_king_studios/matchers/active_model/have_errors/error_expectation'
+require 'sleeping_king_studios/tools/enumerable_tools'
+require 'sleeping_king_studios/tools/string_tools'
 
 module RSpec::SleepingKingStudios::Matchers::ActiveModel
   # Matcher for testing ActiveModel object validations.
-  # 
+  #
   # @since 1.0.0
   class HaveErrorsMatcher < RSpec::SleepingKingStudios::Matchers::BaseMatcher
     include RSpec::SleepingKingStudios::Matchers::ActiveModel::HaveErrors
+    include SleepingKingStudios::Tools::EnumerableTools
+    include SleepingKingStudios::Tools::StringTools
 
     def initialize
       super
@@ -19,12 +23,55 @@ module RSpec::SleepingKingStudios::Matchers::ActiveModel
       @error_expectations = []
     end # constructor
 
+    # Generates a description of the matcher expectation.
+    #
+    # @return [String] The matcher description.
+    def description
+      message = 'have errors'
+
+      attribute_messages = @error_expectations.select(&:expected).map do |expectation|
+        attribute_message = ":#{expectation.attribute}"
+
+        error_messages = expectation.messages.select(&:expected).map do |message_expectation|
+          %{"#{message_expectation.message}"}
+        end # map
+
+        unless error_messages.empty?
+          attribute_message << " with #{pluralize(error_messages.count, 'message', 'messages')} #{humanize_list error_messages}"
+        end # unless
+
+        attribute_message
+      end # each
+      message << " on #{attribute_messages.join(", and on ")}" unless attribute_messages.empty?
+
+      message
+    end # method description
+
+    # Checks if the object can be validated, whether the object is valid, and
+    # checks the errors on the object against the expected errors and messages
+    # from #on and #with_message, if any.
+    #
+    # @param [Object] actual the object to test against the matcher
+    #
+    # @return [Boolean] true if the object responds to :valid? and is valid
+    #   or object.errors does not match the specified errors and messages (if
+    #   any); otherwise false
+    #
+    # @see #matches?
+    def does_not_match? actual
+      @negative_expectation = true
+
+      return false unless @validates = actual.respond_to?(:valid?)
+
+      !matches?(actual)
+    end # method does_not_match?
+
     # Checks if the object can be validated, whether the object is valid, and
     # checks the errors on the object against the expected errors and messages
     # from #on and #with_message, if any.
-    # 
+    #
     # @param [Object] actual the object to test against the matcher
-    # 
+    #
     # @return [Boolean] true if the object responds to :valid?, is not valid,
     #   and object.errors matches the specified errors and messages (if any);
     #   otherwise false
@@ -39,55 +86,56 @@ module RSpec::SleepingKingStudios::Matchers::ActiveModel
 
     # Adds an error expectation. If the actual object does not have an error on
     # the specified attribute, #matches? will return false.
-    # 
+    #
     # @param [String, Symbol] attribute
-    # 
+    #
     # @return [HaveErrorsMatcher] self
-    # 
+    #
     # @example Setting an error expectation
     #   expect(actual).to have_errors.on(:foo)
     def on attribute
       @error_expectations << ErrorExpectation.new(attribute)
-      
+
       self
     end # method on
 
     # Adds a message expectation for the most recently added error attribute.
     # If the actual object does not have an error on the that attribute with
     # the specified message, #matches? will return false.
-    # 
+    #
     # @param [String, Regexp] message the expected error message. If a string,
     #   matcher will check for an exact match; if a regular expression, matcher
     #   will check if the message matches the regexp
-    # 
+    #
     # @raise [ArgumentError] if no error attribute has been added
-    # 
+    #
     # @return [HaveErrorsMatcher] self
-    # 
+    #
     # @example Setting an error and a message expectation
     #   expect(actual).to have_errors.on(:foo).with("can't be blank")
-    # 
+    #
     # @see #on
     def with_message message
       raise ArgumentError.new "no attribute specified for error message" if
         @error_expectations.empty?
-        
+
       @error_expectations.last.messages << MessageExpectation.new(message)
-      
+
       self
     end # method with_message
 
     # Adds a set of message expectations for the most recently added error
     # attribute.
-    # 
+    #
     # @param [Array<String, Regexp>] messages
-    # 
+    #
     # @see #with_message
     def with_messages *messages
       messages.each do |message| self.with_message(message); end
-      
+
       self
     end # method with_message
+    alias_method :with, :with_messages
 
     # @see BaseMatcher#failure_message
     def failure_message
@@ -109,14 +157,17 @@ module RSpec::SleepingKingStudios::Matchers::ActiveModel
     # @see BaseMatcher#failure_message_when_negated
     def failure_message_when_negated
       # Failure cases:
+      # * object is not a model ("to respond to valid")
       # * expected one or more errors, received one or more ("not to have
       #   errors")
       # * expected one or more messages on attribute, received one or more
       #   ("not to have errors on")
       # * expected specific messages on attribute, received all ("not to have
       #   errors on")
-      
-      if expected_errors.empty?
+
+      if !@validates
+        "expected #{@actual.inspect} to respond to :valid?"
+      elsif expected_errors.empty?
         return "expected #{@actual.inspect} not to have errors#{received_errors_message}"
       else
         return "expected #{@actual.inspect} not to have errors#{expected_errors_message}#{received_errors_message}"
@@ -124,7 +175,7 @@ module RSpec::SleepingKingStudios::Matchers::ActiveModel
     end # method failure_message_when_negated
 
     private
-    
+
     def attributes_have_errors?
       # Iterate through the received errors and match them against the expected
       # errors and messages.
@@ -155,7 +206,7 @@ module RSpec::SleepingKingStudios::Matchers::ActiveModel
               else
                 error_expectation.messages << MessageExpectation.new(message, false, true)
               end # if-else
-            end # each  
+            end # each
           end # unless
         else
           error_expectation = ErrorExpectation.new attribute, false, true
@@ -175,7 +226,7 @@ module RSpec::SleepingKingStudios::Matchers::ActiveModel
         error_expectation.expected
       end # select
     end # method expected_errors
-    
+
     def missing_errors
       @error_expectations.select do |error_expectation|
         error_expectation.expected && !error_expectation.received
@@ -197,7 +248,7 @@ module RSpec::SleepingKingStudios::Matchers::ActiveModel
     def expected_errors_message
       "\n  expected errors:" + expected_errors.map do |error_expectation|
         "\n    #{error_expectation.attribute}: " + (error_expectation.messages.empty? ?
-          "(any)" :
+          "(#{@negative_expectation ? 'none' : 'any'})" :
           error_expectation.messages.expected.map(&:message).map(&:inspect).join(", "))
       end.join # map
     end # method expected_errors_message

data/lib/rspec/sleeping_king_studios/matchers/active_model.rb

@@ -1,5 +1,8 @@
 # lib/rspec/sleeping_king_studios/matchers/active_model.rb
 
-Dir[File.join File.dirname(__FILE__), 'active_model', '*.rb'].each do |file|
-  require file
-end # end each
+require 'rspec/sleeping_king_studios/matchers'
+
+module RSpec::SleepingKingStudios::Matchers
+  # Matchers for ActiveModel object validation testing.
+  module ActiveModel; end
+end # module

data/lib/rspec/sleeping_king_studios/matchers/all.rb

@@ -0,0 +1,5 @@
+# lib/rspec/sleeping_king_studios/matchers/all.rb
+
+%w(active_model built_in core).each do |dir_name|
+  require File.join File.dirname(__FILE__), dir_name, 'all'
+end # each

data/lib/rspec/sleeping_king_studios/matchers/base_matcher.rb

@@ -1,6 +1,6 @@
 # lib/rspec/sleeping_king_studios/matchers/base_matcher.rb
 
-require 'rspec/sleeping_king_studios/matchers/require'
+require 'rspec/sleeping_king_studios/matchers'
 
 module RSpec::SleepingKingStudios::Matchers
   # Minimal implementation of the RSpec matcher interface.
@@ -20,6 +20,17 @@ module RSpec::SleepingKingStudios::Matchers
       "#{name_to_sentence}#{to_sentence @expected}"
     end # method description
 
+    # Inverse of #matches? method.
+    #
+    # @param [Object] actual the object to test against the matcher
+    # 
+    # @return [Boolean] false if the object matches, otherwise true
+    # 
+    # @see #matches?
+    def does_not_match? actual
+      !matches?(actual)
+    end # method does_not_match?
+
     # Tests the actual object to see if it matches the defined condition(s).
     # Invoked by RSpec expectations.
     #
@@ -28,6 +39,7 @@ module RSpec::SleepingKingStudios::Matchers
     # @return [Boolean] true if the object matches, otherwise false
     def matches? actual
       @actual = actual
+
       true
     end # method matches?
 
@@ -42,5 +54,12 @@ module RSpec::SleepingKingStudios::Matchers
     def failure_message_when_negated
       "expected #{@actual.inspect} not to #{description}"
     end # method failure_message_when_negated
+
+    private
+
+    # @api private
+    def name_to_sentence
+      'match'
+    end # method name_to_sentence
   end # class
 end # module

data/lib/rspec/sleeping_king_studios/matchers/built_in/all.rb

@@ -0,0 +1,5 @@
+# lib/rspec/sleeping_king_studios/matchers/built_in/all.rb
+
+Dir[File.join File.dirname(__FILE__), '*.rb'].each do |file|
+  require file
+end # end each

data/lib/rspec/sleeping_king_studios/matchers/built_in/be_kind_of.rb

@@ -1,17 +1,27 @@
 # lib/rspec/sleeping_king_studios/matchers/built_in/be_kind_of.rb
 
-require 'rspec/sleeping_king_studios/matchers/built_in/require'
+require 'rspec/sleeping_king_studios/matchers/built_in'
+require 'sleeping_king_studios/tools/enumerable_tools'
 
 module RSpec::SleepingKingStudios::Matchers::BuiltIn
   class BeAKindOfMatcher < RSpec::Matchers::BuiltIn::BeAKindOf
+    include SleepingKingStudios::Tools::EnumerableTools
+
+    # Generates a description of the matcher expectation.
+    #
+    # @return [String] The matcher description.
+    def description
+      message = "be #{type_string}"
+    end # method description
+
     # Checks if the object matches one of the specified types. Allows an
     # expected value of nil as a shortcut for expecting an instance of
     # NilClass.
-    # 
+    #
     # @param [Module, nil, Array<Module, nil>] expected the type or types to
     #   check the object against
     # @param [Object] actual the object to check
-    # 
+    #
     # @return [Boolean] true if the object matches one of the specified types,
     #   otherwise false
     def match expected, actual
@@ -22,14 +32,14 @@ module RSpec::SleepingKingStudios::Matchers::BuiltIn
     def failure_message
       "expected #{@actual.inspect} to be #{type_string}"
     end # method failure_message
-    
+
     # @see BaseMatcher#failure_message_when_negated
     def failure_message_when_negated
       "expected #{@actual.inspect} not to be #{type_string}"
     end # method failure_message_when_negated
 
     private
-    
+
     def match_type? expected
       case
       when expected.nil?
@@ -46,11 +56,7 @@ module RSpec::SleepingKingStudios::Matchers::BuiltIn
       when @expected.nil?
         @expected.inspect
       when @expected.is_a?(Enumerable) && 1 < @expected.count
-        if 2 == expected.count
-          "a #{expected.first.inspect} or #{expected.last.inspect}"
-        else
-          "a #{expected[0..-2].map(&:inspect).join(", ")}, or #{expected.last.inspect}"
-        end # if-else
+        "a #{humanize_list @expected.map { |value| value.nil? ? 'nil' : value }, :last_separator => ' or '}"
       else
         "a #{expected}"
       end # case

data/lib/rspec/sleeping_king_studios/matchers/built_in/include.rb

@@ -1,12 +1,12 @@
 # lib/rspec/sleeping_king_studios/matchers/built_in/be_kind_of.rb
 
-require 'rspec/sleeping_king_studios/matchers/built_in/require'
+require 'rspec/sleeping_king_studios/matchers/built_in'
 
 module RSpec::SleepingKingStudios::Matchers::BuiltIn
   class IncludeMatcher < RSpec::Matchers::BuiltIn::Include
     # @param [Array<Hash, Proc, Object>] expected the items expected to be
     #   matched by the actual object
-    # 
+    #
     # @yield if a block is provided, the block is converted to a proc and
     #   appended to the item expectations
     # @yieldparam [Object] item an item from the actual object; yield(item)
@@ -14,6 +14,7 @@ module RSpec::SleepingKingStudios::Matchers::BuiltIn
     #    predicate
     def initialize *expected, &block
       expected << block if block_given?
+
       super *expected
     end # constructor
 
@@ -31,19 +32,27 @@ module RSpec::SleepingKingStudios::Matchers::BuiltIn
 
     # @see BaseMatcher#failure_message
     def failure_message
-      return "expected #{@actual.inspect} to respond to :include?" if false === @includes
+      message = super
+
+      message << ", but it does not respond to `include?`" unless actual.respond_to?(:include?) || message =~ /does not respond to/
 
-      super
+      message
     end # method failure_message_for_should
 
     # @see BaseMatcher#failure_message_when_negated
     def failure_message_when_negated
-      super
+      message = super
+
+      message << ", but it does not respond to `include?`" unless actual.respond_to?(:include?) || message =~ /does not respond to/
+
+      message
     end # method
 
     private
 
     def perform_match(predicate, hash_subset_predicate)
+      return false unless actual.respond_to?(:include?)
+
       expected.__send__(predicate) do |expected_item|
         if comparing_proc?(expected_item)
           actual_matches_proc?(expected_item)
@@ -59,10 +68,6 @@ module RSpec::SleepingKingStudios::Matchers::BuiltIn
       end
     end
 
-    def actual_collection_includes? expected_item
-      (@includes = actual.respond_to?(:include?)) && super
-    end # method actual_collection_includes?
-
     def actual_matches_proc? expected_item
       !!actual.detect(&expected_item)
     end # method actual_matches_proc?