rspec-change_collection 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 35c1ee5d89f409e7c505ae39bbeabbfd5cd24ed2
+  data.tar.gz: 8f0ff47697b3bfc820986294caac6ff53e77a150
+SHA512:
+  metadata.gz: e5ca1c7ff55c451e9de650af42801839f8932d4e9936f224376b76d2f956731a4d61e60774a5399cf9d93b358bbcfa1a1bd7c6dc9b947961f54abc481da91d06
+  data.tar.gz: 125a3c749b10661f0ca74c0f9069d47be24acfd08ec52e026e77b807d8d80439e1c885232b872279594488e634f6c33da6cc0acb848b6eb476c7adc22bd708f3

data/.gitignore

@@ -0,0 +1,2 @@
+.idea/*
+.ruby-*

data/Changelog.md

@@ -0,0 +1,4 @@
+### 1.0.0
+
+Initial Version
+

data/Gemfile

@@ -0,0 +1,27 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rspec-change_collection.gemspec
+gemspec
+
+%w[rspec rspec-core rspec-expectations rspec-mocks rspec-support].each do |lib|
+  branch = ENV.fetch('BRANCH','master')
+  next if branch == '2-99-maintenance' && lib == 'rspec-support'
+  library_path = File.expand_path("../../#{lib}", __FILE__)
+  if File.exist?(library_path)
+    gem lib, :path => library_path
+  else
+    gem lib, :git => "git://github.com/rspec/#{lib}.git",
+             :branch => branch
+  end
+end
+
+# test coverage
+# gem 'simplecov', :require => false
+
+gem 'coveralls', :require => false, :platform => :mri_20
+
+eval File.read('Gemfile-custom') if File.exist?('Gemfile-custom')
+
+platform :rbx do
+  gem 'rubysl'
+end

data/Gemfile.lock

@@ -0,0 +1,294 @@
+GIT
+  remote: git://github.com/rspec/rspec-core.git
+  revision: e0a8404b0ab3f7803eedca9572f3fbfbea915bd6
+  branch: master
+  specs:
+    rspec-core (3.1.0.pre)
+      rspec-support (= 3.1.0.pre)
+
+GIT
+  remote: git://github.com/rspec/rspec-expectations.git
+  revision: e4674ca2440d22ecfe59be6fe351396dbe9b4369
+  branch: master
+  specs:
+    rspec-expectations (3.1.0.pre)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (= 3.1.0.pre)
+
+GIT
+  remote: git://github.com/rspec/rspec-mocks.git
+  revision: 873d755efe61d500444c230dc3b7f4f9d24aed43
+  branch: master
+  specs:
+    rspec-mocks (3.1.0.pre)
+      rspec-support (= 3.1.0.pre)
+
+GIT
+  remote: git://github.com/rspec/rspec-support.git
+  revision: ba5b67666514d5808da13ddaafefc8c597e553e1
+  branch: master
+  specs:
+    rspec-support (3.1.0.pre)
+
+GIT
+  remote: git://github.com/rspec/rspec.git
+  revision: 2b826653e1f55f63e4f99d8dd1f14b5d35d0a0b7
+  branch: master
+  specs:
+    rspec (3.1.0.pre)
+      rspec-core (= 3.1.0.pre)
+      rspec-expectations (= 3.1.0.pre)
+      rspec-mocks (= 3.1.0.pre)
+
+PATH
+  remote: .
+  specs:
+    rspec-change_collection (1.0.0)
+      rspec-core (>= 2.99.0.beta1)
+      rspec-expectations (>= 2.99.0.beta1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    coveralls (0.7.0)
+      multi_json (~> 1.3)
+      rest-client
+      simplecov (>= 0.7)
+      term-ansicolor
+      thor
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    ffi2-generators (0.1.1)
+    mime-types (2.3)
+    multi_json (1.10.1)
+    netrc (0.7.7)
+    rake (10.1.1)
+    rest-client (1.7.2)
+      mime-types (>= 1.16, < 3.0)
+      netrc (~> 0.7)
+    rubysl (2.0.15)
+      rubysl-abbrev (~> 2.0)
+      rubysl-base64 (~> 2.0)
+      rubysl-benchmark (~> 2.0)
+      rubysl-bigdecimal (~> 2.0)
+      rubysl-cgi (~> 2.0)
+      rubysl-cgi-session (~> 2.0)
+      rubysl-cmath (~> 2.0)
+      rubysl-complex (~> 2.0)
+      rubysl-continuation (~> 2.0)
+      rubysl-coverage (~> 2.0)
+      rubysl-csv (~> 2.0)
+      rubysl-curses (~> 2.0)
+      rubysl-date (~> 2.0)
+      rubysl-delegate (~> 2.0)
+      rubysl-digest (~> 2.0)
+      rubysl-drb (~> 2.0)
+      rubysl-e2mmap (~> 2.0)
+      rubysl-english (~> 2.0)
+      rubysl-enumerator (~> 2.0)
+      rubysl-erb (~> 2.0)
+      rubysl-etc (~> 2.0)
+      rubysl-expect (~> 2.0)
+      rubysl-fcntl (~> 2.0)
+      rubysl-fiber (~> 2.0)
+      rubysl-fileutils (~> 2.0)
+      rubysl-find (~> 2.0)
+      rubysl-forwardable (~> 2.0)
+      rubysl-getoptlong (~> 2.0)
+      rubysl-gserver (~> 2.0)
+      rubysl-io-console (~> 2.0)
+      rubysl-io-nonblock (~> 2.0)
+      rubysl-io-wait (~> 2.0)
+      rubysl-ipaddr (~> 2.0)
+      rubysl-irb (~> 2.0)
+      rubysl-logger (~> 2.0)
+      rubysl-mathn (~> 2.0)
+      rubysl-matrix (~> 2.0)
+      rubysl-mkmf (~> 2.0)
+      rubysl-monitor (~> 2.0)
+      rubysl-mutex_m (~> 2.0)
+      rubysl-net-ftp (~> 2.0)
+      rubysl-net-http (~> 2.0)
+      rubysl-net-imap (~> 2.0)
+      rubysl-net-pop (~> 2.0)
+      rubysl-net-protocol (~> 2.0)
+      rubysl-net-smtp (~> 2.0)
+      rubysl-net-telnet (~> 2.0)
+      rubysl-nkf (~> 2.0)
+      rubysl-observer (~> 2.0)
+      rubysl-open-uri (~> 2.0)
+      rubysl-open3 (~> 2.0)
+      rubysl-openssl (~> 2.0)
+      rubysl-optparse (~> 2.0)
+      rubysl-ostruct (~> 2.0)
+      rubysl-pathname (~> 2.0)
+      rubysl-prettyprint (~> 2.0)
+      rubysl-prime (~> 2.0)
+      rubysl-profile (~> 2.0)
+      rubysl-profiler (~> 2.0)
+      rubysl-pstore (~> 2.0)
+      rubysl-pty (~> 2.0)
+      rubysl-rational (~> 2.0)
+      rubysl-readline (~> 2.0)
+      rubysl-resolv (~> 2.0)
+      rubysl-rexml (~> 2.0)
+      rubysl-rinda (~> 2.0)
+      rubysl-rss (~> 2.0)
+      rubysl-scanf (~> 2.0)
+      rubysl-securerandom (~> 2.0)
+      rubysl-set (~> 2.0)
+      rubysl-shellwords (~> 2.0)
+      rubysl-singleton (~> 2.0)
+      rubysl-socket (~> 2.0)
+      rubysl-stringio (~> 2.0)
+      rubysl-strscan (~> 2.0)
+      rubysl-sync (~> 2.0)
+      rubysl-syslog (~> 2.0)
+      rubysl-tempfile (~> 2.0)
+      rubysl-thread (~> 2.0)
+      rubysl-thwait (~> 2.0)
+      rubysl-time (~> 2.0)
+      rubysl-timeout (~> 2.0)
+      rubysl-tmpdir (~> 2.0)
+      rubysl-tsort (~> 2.0)
+      rubysl-un (~> 2.0)
+      rubysl-uri (~> 2.0)
+      rubysl-weakref (~> 2.0)
+      rubysl-webrick (~> 2.0)
+      rubysl-xmlrpc (~> 2.0)
+      rubysl-yaml (~> 2.0)
+      rubysl-zlib (~> 2.0)
+    rubysl-abbrev (2.0.4)
+    rubysl-base64 (2.0.0)
+    rubysl-benchmark (2.0.1)
+    rubysl-bigdecimal (2.0.2)
+    rubysl-cgi (2.0.1)
+    rubysl-cgi-session (2.0.1)
+    rubysl-cmath (2.0.0)
+    rubysl-complex (2.0.0)
+    rubysl-continuation (2.0.0)
+    rubysl-coverage (2.0.3)
+    rubysl-csv (2.0.2)
+      rubysl-english (~> 2.0)
+    rubysl-curses (2.0.1)
+    rubysl-date (2.0.6)
+    rubysl-delegate (2.0.1)
+    rubysl-digest (2.0.3)
+    rubysl-drb (2.0.1)
+    rubysl-e2mmap (2.0.0)
+    rubysl-english (2.0.0)
+    rubysl-enumerator (2.0.0)
+    rubysl-erb (2.0.1)
+    rubysl-etc (2.0.3)
+      ffi2-generators (~> 0.1)
+    rubysl-expect (2.0.0)
+    rubysl-fcntl (2.0.4)
+      ffi2-generators (~> 0.1)
+    rubysl-fiber (2.0.0)
+    rubysl-fileutils (2.0.3)
+    rubysl-find (2.0.1)
+    rubysl-forwardable (2.0.1)
+    rubysl-getoptlong (2.0.0)
+    rubysl-gserver (2.0.0)
+      rubysl-socket (~> 2.0)
+      rubysl-thread (~> 2.0)
+    rubysl-io-console (2.0.0)
+    rubysl-io-nonblock (2.0.0)
+    rubysl-io-wait (2.0.0)
+    rubysl-ipaddr (2.0.0)
+    rubysl-irb (2.0.4)
+      rubysl-e2mmap (~> 2.0)
+      rubysl-mathn (~> 2.0)
+      rubysl-readline (~> 2.0)
+      rubysl-thread (~> 2.0)
+    rubysl-logger (2.0.0)
+    rubysl-mathn (2.0.0)
+    rubysl-matrix (2.1.0)
+      rubysl-e2mmap (~> 2.0)
+    rubysl-mkmf (2.0.1)
+      rubysl-fileutils (~> 2.0)
+      rubysl-shellwords (~> 2.0)
+    rubysl-monitor (2.0.0)
+    rubysl-mutex_m (2.0.0)
+    rubysl-net-ftp (2.0.1)
+    rubysl-net-http (2.0.4)
+      rubysl-cgi (~> 2.0)
+      rubysl-erb (~> 2.0)
+      rubysl-singleton (~> 2.0)
+    rubysl-net-imap (2.0.1)
+    rubysl-net-pop (2.0.1)
+    rubysl-net-protocol (2.0.1)
+    rubysl-net-smtp (2.0.1)
+    rubysl-net-telnet (2.0.0)
+    rubysl-nkf (2.0.1)
+    rubysl-observer (2.0.0)
+    rubysl-open-uri (2.0.0)
+    rubysl-open3 (2.0.0)
+    rubysl-openssl (2.1.0)
+    rubysl-optparse (2.0.1)
+      rubysl-shellwords (~> 2.0)
+    rubysl-ostruct (2.0.4)
+    rubysl-pathname (2.0.0)
+    rubysl-prettyprint (2.0.3)
+    rubysl-prime (2.0.1)
+    rubysl-profile (2.0.0)
+    rubysl-profiler (2.0.1)
+    rubysl-pstore (2.0.0)
+    rubysl-pty (2.0.2)
+    rubysl-rational (2.0.1)
+    rubysl-readline (2.0.2)
+    rubysl-resolv (2.1.0)
+    rubysl-rexml (2.0.2)
+    rubysl-rinda (2.0.1)
+    rubysl-rss (2.0.0)
+    rubysl-scanf (2.0.0)
+    rubysl-securerandom (2.0.0)
+    rubysl-set (2.0.1)
+    rubysl-shellwords (2.0.0)
+    rubysl-singleton (2.0.0)
+    rubysl-socket (2.0.1)
+    rubysl-stringio (2.0.0)
+    rubysl-strscan (2.0.0)
+    rubysl-sync (2.0.0)
+    rubysl-syslog (2.0.1)
+      ffi2-generators (~> 0.1)
+    rubysl-tempfile (2.0.1)
+    rubysl-thread (2.0.2)
+    rubysl-thwait (2.0.0)
+    rubysl-time (2.0.3)
+    rubysl-timeout (2.0.0)
+    rubysl-tmpdir (2.0.1)
+    rubysl-tsort (2.0.1)
+    rubysl-un (2.0.0)
+      rubysl-fileutils (~> 2.0)
+      rubysl-optparse (~> 2.0)
+    rubysl-uri (2.0.0)
+    rubysl-weakref (2.0.0)
+    rubysl-webrick (2.0.0)
+    rubysl-xmlrpc (2.0.0)
+    rubysl-yaml (2.0.4)
+    rubysl-zlib (2.0.1)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    term-ansicolor (1.3.0)
+      tins (~> 1.0)
+    thor (0.19.1)
+    tins (1.3.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3)
+  coveralls
+  rake (~> 10.1.0)
+  rspec!
+  rspec-change_collection!
+  rspec-core!
+  rspec-expectations!
+  rspec-mocks!
+  rspec-support!
+  rubysl

data/LICENSE.txt

@@ -0,0 +1,28 @@
+(The MIT License)
+
+Copyright (c) 2014 Andrew Brown
+Copyright (c) 2013 Peter Alfvin
+Copyright (c) 2012 David Chelimsky, Myron Marston
+Copyright (c) 2006 David Chelimsky, The RSpec Development Team
+Copyright (c) 2005 Steven Baker
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,43 @@
+# RSpec::ChangeCollection [![Build Status](https://travis-ci.org/dontfidget/rspec-change_collection.png)](https://travis-ci.org/dontfidget/rspec-change_collection)
+
+RSpec::ChangeCollection provides the `to_include` and `to_exclude` methods to the `change` for blocks that return a collection.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'rspec-change_collection'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install rspec-change_collection
+
+And require it as:
+
+    require 'rspec/change_collection'
+
+## Usage
+
+Use the `to_include` and `to_exclude` methods to make assertions about the effect of an rspec `change` block.
+
+Both `to_include` and `to_exclude` accept objects or blocks.  You can pass it a list of objects:
+
+    array = []
+    expect { array << 1 << 2 }.to change { array }.to_include 1, 2
+
+And you can use block to make claims about any of the items before and after the change:
+
+    array = [1]
+    expect { array << 2 }.to change { array }.to_include(&:even?)
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,13 @@
+require "bundler"
+Bundler.setup
+Bundler::GemHelper.install_tasks
+
+require "rake"
+require "rspec/core/rake_task"
+
+desc "Run all examples"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.ruby_opts = %w[-w]
+end
+
+task :default => :spec

data/lib/rspec/change_collection.rb

@@ -0,0 +1,172 @@
+require 'rspec/change_collection/version'
+require 'rspec/core'
+require 'rspec/expectations'
+
+module RSpec::Matchers
+  module ChangeCollection
+    class Change < RSpec::Matchers::BuiltIn::Change
+      def initialize(receiver=nil, message=nil, &block)
+        @expected_to_include = []
+        @expected_to_exclude = []
+
+        @missing_original_items = []
+        @extra_original_items = []
+
+        @missing_final_items = []
+        @extra_final_items = []
+
+        super
+      end
+
+      def matches?(*)
+        @parent_matches = super
+
+        if expect_collection_to_change?
+          actual_before = @change_details.actual_before
+          actual_after = @change_details.actual_after
+
+          if actual_before.respond_to?(:to_ary)
+            @missing_original_items = extract_items(@expected_to_exclude) - actual_before
+            @missing_original_items += reject_procs(actual_before, @expected_to_exclude)
+            @extra_original_items = select_items(actual_before, @expected_to_include) & actual_before
+          end
+
+          if actual_after.respond_to?(:to_ary)
+            @missing_final_items = extract_items(@expected_to_include) - actual_after
+            @missing_final_items += reject_procs(actual_after, @expected_to_include)
+            @extra_final_items = select_items(actual_after, @expected_to_exclude) & actual_after
+          end
+        end
+
+        @parent_matches && ![
+          @missing_original_items,
+          @extra_original_items,
+          @missing_final_items,
+          @extra_final_items
+        ].map(&:empty?).include?(false)
+      end
+
+      def failure_message
+        if @parent_matches
+          message =  ""
+        else
+          message = super
+        end
+
+        if expect_collection_to_change?
+          array_messages = []
+          append_array_message = lambda do |message, values|
+            array_messages << "#{message}#{values.inspect}" if values.length > 0
+          end
+          append_array_message.call(
+            "the original collection should have included:     ",
+            @missing_original_items
+          )
+          append_array_message.call(
+            "the original collection should not have included: ",
+            @extra_original_items
+          )
+          append_array_message.call(
+            "the final collection should have included:        ",
+            @missing_final_items
+          )
+          append_array_message.call(
+            "the final collection should not have included:    ",
+            @extra_final_items
+          )
+          append_array_message.call(
+            "the original collection was:                      ",
+            @change_details.actual_before
+          )
+          append_array_message.call(
+            "the final collection was:                         ",
+            @change_details.actual_after
+          )
+          message << "\n#{array_messages.join "\n"}\n" unless array_messages.empty?
+          message
+        end
+
+        message
+      end
+
+      def failure_message_when_negated
+        return "Matcher does not support negation" if expect_collection_to_change?
+        super
+      end
+
+      def to_include(*items, &block)
+        check_arguments(__method__, *items, &block)
+        @expected_to_include << items
+        @expected_to_include << block if block
+        self
+      end
+
+      def to_exclude(*items, &block)
+        check_arguments(__method__, *items, &block)
+        @expected_to_exclude << items
+        @expected_to_exclude << block if block
+        self
+      end
+
+      private
+
+      def callable?(rule)
+        rule.respond_to?(:call)
+      end
+
+      def extract_items(rules)
+        rules.reject { |rule| callable?(rule) }.flatten(1)
+      end
+
+      def reject_procs(items, rules)
+        rules.select { |rule| callable?(rule) }.reject { |proc| items.any? { |item| proc.call(item) }}
+      end
+
+      def select_items(items, rules)
+        items.select { |item| item_in_rules?(item, rules) }
+      end
+
+      def item_in_rules?(item, rules)
+        rules.any? do |rule|
+          if callable?(rule)
+            rule.call(item)
+          else
+            rule.include?(item)
+          end
+        end
+      end
+
+      def expect_collection_to_change?
+        [@expected_to_include, @expected_to_exclude].map(&:empty?).include?(false)
+      end
+
+      def safe_sort(array)
+        array.sort rescue array
+      end
+
+      def check_arguments(method, *items, &block)
+        if block && !items.empty?
+          raise(
+            ArgumentError,
+            "`#{method}` requires either objects " \
+            "(`to_include(obj1, obj2, ...)`) or a block (`to_include { }`) but not both. "
+          )
+        end
+      end
+    end
+  end
+
+  def change_with_collection(receiver=nil, message=nil, &block)
+    RSpec::Matchers::ChangeCollection::Change.new(receiver, message, &block)
+  end
+
+  alias_method :change_without_collection, :change_with_collection
+  alias_method :change, :change_with_collection
+end
+
+RSpec.configure do |rspec|
+  rspec.extend RSpec::Matchers::ChangeCollection
+  rspec.backtrace_exclusion_patterns << %r(/lib/rspec/change_collection)
+end
+
+RSpec::SharedContext.send(:include, RSpec::Matchers::ChangeCollection)

data/lib/rspec/change_collection/version.rb

@@ -0,0 +1,5 @@
+module RSpec
+  module ChangeCollection
+    VERSION = "1.0.0"
+  end
+end

data/rspec-change_collection.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'rspec/change_collection/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "rspec-change_collection"
+  spec.version       = RSpec::ChangeCollection::VERSION
+  spec.authors       = ["Andrew S. Brown"]
+  spec.email         = ["andrew@dontfidget.com"]
+  spec.description   = %q{RSpec extension gem for attribute matching}
+  spec.summary       = %q{Provides "change_collection" method formally part of rspec-core}
+  spec.homepage      = "https://github.com/dontfidget/rspec-change_collection"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency 'rspec-core', '>= 2.99.0.beta1'
+  spec.add_runtime_dependency 'rspec-expectations', '>= 2.99.0.beta1'
+  spec.add_development_dependency 'bundler',  '~> 1.3'
+  spec.add_development_dependency 'rake',     '~> 10.1.0'
+
+end

data/script/test_all

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+set -e -x
+
+# idea taken from: http://blog.headius.com/2010/03/jruby-startup-time-tips.html
+export JRUBY_OPTS='-X-C' # disable JIT since these processes are so short lived
+
+# force jRuby to use client mode JVM or a compilation mode thats as close as possible,
+# idea taken from https://github.com/jruby/jruby/wiki/Improving-startup-time
+export JAVA_OPTS='-client -XX:+TieredCompilation -XX:TieredStopAtLevel=1'
+
+echo "Running rspec specs"
+bin/rspec spec --format progress --profile

data/spec/rspec/change_collection_spec.rb

@@ -0,0 +1,233 @@
+require 'spec_helper'
+
+module RSpec
+  describe ChangeCollection do
+    shared_examples_for :original_change do
+      it "detects simple changes" do
+        array = []
+        expect {
+          array = [1]
+        }.to change { array }
+      end
+
+      it "raises exceptions when expectations are not met" do
+        array = []
+        expect {
+          expect {
+            array << 1
+          }.not_to change { array.length }
+        }.to raise_exception(RSpec::Expectations::ExpectationNotMetError)
+      end
+
+      it "provides the 'from' and 'to' change helpers" do
+        array = []
+        expect {
+          expect {
+            array << 1
+          }.to change { array.length }.from(0).to(2)
+        }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+      end
+
+      it "provides the 'by' change helper" do
+        array = []
+        expect {
+          expect {
+            array << 1
+          }.to change { array.length }.by(2)
+        }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+      end
+    end
+
+    describe "#to_include" do
+      it_behaves_like :original_change
+
+      it "succeeds when items have been added to the collection" do
+        array = []
+        expect {
+          array += [1]
+        }.to change { array} .to_include(1)
+      end
+      it "succeeds when multiple items have been added to the collection" do
+        array = []
+        expect {
+          array += [1, 2]
+        }.to change { array }.to_include(1,2)
+      end
+      it "still succeeds when the items are arrays" do
+        array = []
+        expect {
+          array << [1]
+        }.to change { array }.to_include([1])
+      end
+      it "fails when items have not been added to the collection" do
+        array = []
+        expect {
+          expect {
+          }.to change { array }.to_include(1)
+        }.to raise_error(RSpec::Expectations::ExpectationNotMetError,
+                         /the final collection should have included.*\[1\]/)
+      end
+      it "fails when any item has not been added to the collection" do
+        array = []
+        expect {
+          expect {
+            array += [1]
+          }.to change { array }.to_include(1,2)
+        }.to raise_error(RSpec::Expectations::ExpectationNotMetError,
+                         /the final collection should have included.*\[2\]/)
+      end
+      it "fails when an item to include was already included" do
+        array = [1]
+        expect {
+          expect {
+          }.to change { array }.to_include(1)
+        }.to raise_error(RSpec::Expectations::ExpectationNotMetError,
+                         /the original collection should not have included.*\[1\]/)
+      end
+
+      describe "with a block" do
+        it "passes if initial condition is not met by non-empty-array and final condition is met" do
+          array = [1,3]
+          expect {
+            array << 2
+          }.to change { array }.to_include(&:even?)
+        end
+
+        it "passes if initial condition is not met by empty array and final condition is met" do
+          array = []
+          expect {
+            array << 2
+          }.to change { array }.to_include(&:even?)
+        end
+
+        it "fails if initial condition is not met and final condition is still not met" do
+          array = [1,3]
+          expect {
+            expect {
+              array << 5
+            }.to change { array }.to_include(&:even?)
+          }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+        end
+
+        it "fails if there is no change in array" do
+          array = [1,3]
+          expect {
+            expect {
+              # nop
+            }.to change { array }.to_include(&:even?)
+          }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+        end
+
+        it "fails if also passed an item" do
+          array = []
+          expect {
+            expect {
+              # nop
+            }.to change { array }.to_include(1, &:even?)
+          }.to raise_error(ArgumentError)
+        end
+      end
+    end
+
+    describe "#to_exclude" do
+      it_behaves_like :original_change
+
+      it "passes if the specified item has been removed from the collection" do
+        array = [1]
+        expect {
+          array = []
+        }.to change { array }.to_exclude(1)
+      end
+
+      it "passes if all of multiple specified items have been removed from the collection" do
+        array = [1,2]
+        expect {
+          array = []
+        }.to change { array }.to_exclude(1,2)
+      end
+
+      it "fails if any specified item has not been removed from the collection" do
+        array = [1,2]
+        expect {
+          expect {
+            array = [1]
+          }.to change { array }.to_exclude(1,2)
+        }.to raise_error(RSpec::Expectations::ExpectationNotMetError,
+                         /the final collection should not have included.*\[1\]/)
+      end
+
+      it "fails if a specified item was never in the collection" do
+        array = []
+        expect {
+          expect {
+          }.to change { array }.to_exclude(1)
+        }.to raise_error(RSpec::Expectations::ExpectationNotMetError,
+                         /the original collection should have included.*\[1\]/)
+      end
+
+      it "fails if any specified item was never in the collection" do
+        array = [1]
+        expect {
+          expect {
+            array = []
+          }.to change { array }.to_exclude(1,2)
+        }.to raise_error(RSpec::Expectations::ExpectationNotMetError,
+                         /the original collection should have included.*\[2\]/)
+      end
+
+      describe "with a block" do
+        it "passes if initial condition is met and final condition is met" do
+          array = [1,2,3]
+          expect {
+            array -= [2]
+          }.to change { array }.to_exclude(&:even?)
+        end
+
+        it "fails if initial condition is not met by non-empty collection" do
+          array = [1,3]
+          expect {
+            expect {
+              array -= [3]
+            }.to change { array }.to_exclude(&:even?)
+          }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+        end
+
+        it "fails if initial condition is not met by empty collection" do
+          array = []
+          expect {
+            expect {
+              array << 3
+            }.to change { array }.to_exclude(&:even?)
+          }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+        end
+
+        it "fails if final condition is not met" do
+          array = [1,2,3]
+          expect {
+            expect {
+              array -= [3]
+            }.to change { array }.to_exclude(&:even?)
+          }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+        end
+
+        it "fails if there is no change" do
+          array = [2]
+          expect {
+            expect {
+              # nop
+            }.to change { array }.to_exclude(&:even?)
+          }.to raise_error(RSpec::Expectations::ExpectationNotMetError)
+        end
+
+        it "fails if also passed an item" do
+          array = []
+          expect {
+            expect {
+              # nop
+            }.to change { array }.to_include(1, &:even?)
+          }.to raise_error(ArgumentError)
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+require 'rspec/change_collection'
+
+Dir['./spec/support/**/*'].each {|f| require f}
+
+class NullFormatter
+  private
+  def method_missing(method, *args, &block)
+    # ignore
+  end
+end
+
+RSpec.configure do |config|
+  config.run_all_when_everything_filtered = true
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification
+name: rspec-change_collection
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Andrew S. Brown
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.99.0.beta1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.99.0.beta1
+- !ruby/object:Gem::Dependency
+  name: rspec-expectations
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.99.0.beta1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.99.0.beta1
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 10.1.0
+description: RSpec extension gem for attribute matching
+email:
+- andrew@dontfidget.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Changelog.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/rspec/change_collection.rb
+- lib/rspec/change_collection/version.rb
+- rspec-change_collection.gemspec
+- script/test_all
+- spec/rspec/change_collection_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/dontfidget/rspec-change_collection
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Provides "change_collection" method formally part of rspec-core
+test_files:
+- spec/rspec/change_collection_spec.rb
+- spec/spec_helper.rb