shoulda-change_matchers 0.0.1

data/.travis.yml

@@ -0,0 +1,4 @@
+rvm:
+  - ree
+  - 1.9.2
+  - 1.9.3

data/Appraisals

@@ -0,0 +1,7 @@
+appraise "shoulda2" do
+  gem 'shoulda', '~>2.11'
+end
+
+appraise "shoulda3" do
+  gem 'shoulda', '~>3.1'
+end

data/Gemfile

@@ -0,0 +1,7 @@
+source :rubygems
+gemspec
+
+gem "appraisal"
+gem "rake"
+gem "test-unit", ">=2.5.1"
+gem "shoulda"

data/Gemfile.lock

@@ -0,0 +1,34 @@
+PATH
+  remote: .
+  specs:
+    shoulda-change_matchers (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.2.8)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    appraisal (0.4.1)
+      bundler
+      rake
+    i18n (0.6.0)
+    multi_json (1.3.6)
+    rake (0.9.2)
+    shoulda (3.1.1)
+      shoulda-context (~> 1.0)
+      shoulda-matchers (~> 1.2)
+    shoulda-context (1.0.0)
+    shoulda-matchers (1.2.0)
+      activesupport (>= 3.0.0)
+    test-unit (2.5.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  appraisal
+  rake
+  shoulda
+  shoulda-change_matchers!
+  test-unit (>= 2.5.1)

data/Rakefile

@@ -0,0 +1,10 @@
+require 'appraisal'
+require 'bundler/gem_tasks'
+
+task :test do
+  sh "ruby test/shoulda_change_matchers_test.rb"
+end
+
+task :default do
+  sh "bundle exec rake appraisal:install && bundle exec rake appraisal test"
+end

data/Readme.md

@@ -0,0 +1,43 @@
+should_change / should_create / should_destroy matchers for shoulda 3 backported from shoulda 2<br/>
+so you can upgrade to shoulda 3 without rewriting major parts of your test-base.
+
+    gem install shoulda-change_matchers
+
+    # Gemfile
+    gem "shoulda-let", :require => "shoulda/change_matchers"
+
+Usage
+=====
+
+<!-- example -->
+    context "creating" do
+      setup do
+        User.create!
+        User.create!
+      end
+
+      should_change("the number of users", :by => 2) { User.count }
+    end
+
+    context "doing nothing" do
+      should_not_change("the number of users") { User.count }
+    end
+
+    context "creating" do
+      setup{ User.create! }
+      should_create :user
+    end
+
+    context "destroying" do
+      setup{ User.delete_all }
+      should_destroy :user
+    end
+<!-- example -->
+
+
+Author
+======
+[Michael Grosser](http://grosser.it)<br/>
+michael@grosser.it<br/>
+License: MIT<br/>
+[![Build Status](https://secure.travis-ci.org/grosser/shoulda_change_matchers.png)](http://travis-ci.org/grosser/shoulda_change_matchers)

data/gemfiles/shoulda2.gemfile

@@ -0,0 +1,10 @@
+# This file was generated by Appraisal
+
+source :rubygems
+
+gem "appraisal"
+gem "rake"
+gem "test-unit", ">=2.5.1"
+gem "shoulda", "~>2.11"
+
+gemspec :path=>"../"

data/gemfiles/shoulda2.gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: /Users/mgrosser/code/tools/shoulda-change_matchers
+  specs:
+    shoulda-change_matchers (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    appraisal (0.4.1)
+      bundler
+      rake
+    rake (0.9.2.2)
+    shoulda (2.11.3)
+    test-unit (2.5.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  appraisal
+  rake
+  shoulda (~> 2.11)
+  shoulda-change_matchers!
+  test-unit (>= 2.5.1)

data/gemfiles/shoulda3.gemfile

@@ -0,0 +1,10 @@
+# This file was generated by Appraisal
+
+source :rubygems
+
+gem "appraisal"
+gem "rake"
+gem "test-unit", ">=2.5.1"
+gem "shoulda", "~>3.1"
+
+gemspec :path=>"../"

data/gemfiles/shoulda3.gemfile.lock

@@ -0,0 +1,34 @@
+PATH
+  remote: /Users/mgrosser/code/tools/shoulda-change_matchers
+  specs:
+    shoulda-change_matchers (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.2.8)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    appraisal (0.4.1)
+      bundler
+      rake
+    i18n (0.6.0)
+    multi_json (1.3.6)
+    rake (0.9.2.2)
+    shoulda (3.1.1)
+      shoulda-context (~> 1.0)
+      shoulda-matchers (~> 1.2)
+    shoulda-context (1.0.0)
+    shoulda-matchers (1.3.0)
+      activesupport (>= 3.0.0)
+    test-unit (2.5.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  appraisal
+  rake
+  shoulda (~> 3.1)
+  shoulda-change_matchers!
+  test-unit (>= 2.5.1)

data/lib/shoulda/change_matchers.rb

@@ -0,0 +1,165 @@
+require "shoulda"
+require "shoulda/context"
+
+module Shoulda
+  module ChangeMatchers
+    # Macro that creates a test asserting a change between the return value
+    # of a block that is run before and after the current setup block
+    # is run. This is similar to Active Support's <tt>assert_difference</tt>
+    # assertion, but supports more than just numeric values.  See also
+    # should_not_change.
+    #
+    # The passed description will be used when generating the test name and failure messages.
+    #
+    # Example:
+    #
+    #   context "Creating a post" do
+    #     setup { Post.create }
+    #     should_change("the number of posts", :by => 1) { Post.count }
+    #   end
+    #
+    # As shown in this example, the <tt>:by</tt> option expects a numeric
+    # difference between the before and after values of the expression.  You
+    # may also specify <tt>:from</tt> and <tt>:to</tt> options:
+    #
+    #   should_change("the number of posts", :from => 0, :to => 1) { Post.count }
+    #   should_change("the post title", :from => "old", :to => "new") { @post.title }
+    #
+    # Combinations of <tt>:by</tt>, <tt>:from</tt>, and <tt>:to</tt> are allowed:
+    #
+    #   # Assert the value changed in some way:
+    #   should_change("the post title") { @post.title }
+    #
+    #   # Assert the value changed to anything other than "old:"
+    #   should_change("the post title", :from => "old") { @post.title }
+    #
+    #   # Assert the value changed to "new:"
+    #   should_change("the post title", :to => "new") { @post.title }
+    #
+    # This macro was deprecated because these tests aren't as valuable as
+    # alternative tests that explicitly test the final state.
+    #
+    # Consider an alternative:
+    #
+    #   context "updating a post" do
+    #     setup do
+    #       @post = Post.create(:title => "old")
+    #       put :update, :post => {:title => "new"}, :id => @post.to_param
+    #     end
+    #     should "update the title" do
+    #       assert_equal "new", @post.reload.title
+    #     end
+    #   end
+    def should_change(description, options = {}, &block)
+      by, from, to = shoulda_get_options!([options], :by, :from, :to)
+      stmt = "change #{description}"
+      stmt << " from #{from.inspect}" if from
+      stmt << " to #{to.inspect}" if to
+      stmt << " by #{by.inspect}" if by
+
+      before = lambda { @_before_should_change = block.bind(self).call }
+      should stmt, :before => before do
+        old_value = @_before_should_change
+        new_value = block.bind(self).call
+        assert_operator from, :===, old_value, "#{description} did not originally match #{from.inspect}" if from
+        assert_not_equal old_value, new_value, "#{description} did not change" unless by == 0
+        assert_operator to, :===, new_value, "#{description} was not changed to match #{to.inspect}" if to
+        assert_equal old_value + by, new_value if by
+      end
+    end
+
+    # Deprecated.
+    #
+    # Macro that creates a test asserting no change between the return value
+    # of a block that is run before and after the current setup block
+    # is run. This is the logical opposite of should_change.
+    #
+    # The passed description will be used when generating the test name and failure message.
+    #
+    # Example:
+    #
+    #   context "Updating a post" do
+    #     setup { @post.update_attributes(:title => "new") }
+    #     should_not_change("the number of posts") { Post.count }
+    #   end
+    #
+    # This macro was deprecated because these tests aren't as valuable as
+    # alternative tests that explicitly test the final state.
+    #
+    # Consider an alternative:
+    #
+    #   context "updating a post" do
+    #     setup do
+    #       @post = Post.create(:title => "old")
+    #       put :update, :post => {:title => ""}, :id => @post.to_param
+    #     end
+    #     should "not update the title" do
+    #       assert_equal "old", @post.reload.title
+    #     end
+    #   end
+    def should_not_change(description, &block)
+      before = lambda { @_before_should_not_change = block.bind(self).call }
+      should "not change #{description}", :before => before do
+        new_value = block.bind(self).call
+        assert_equal @_before_should_not_change, new_value, "#{description} changed"
+      end
+    end
+
+    # Deprecated.
+    #
+    # Macro that creates a test asserting that a record of the given class was
+    # created.
+    #
+    # Example:
+    #
+    #   context "creating a post" do
+    #     setup { Post.create(post_attributes) }
+    #     should_create :post
+    #   end
+    def should_create(class_name)
+      should_change_record_count_of(class_name, 1, 'create')
+    end
+
+    # Deprecated.
+    #
+    # Macro that creates a test asserting that a record of the given class was
+    # destroyed.
+    #
+    # Example:
+    #
+    #   context "destroying a post" do
+    #     setup { Post.first.destroy }
+    #     should_destroy :post
+    #   end
+    def should_destroy(class_name)
+      should_change_record_count_of(class_name, -1, 'destroy')
+    end
+
+    private
+
+    def should_change_record_count_of(class_name, amount, action) # :nodoc:
+      klass = class_name.to_s.camelize.constantize
+      before = lambda do
+        @_before_change_record_count = klass.count
+      end
+      human_name = class_name.to_s.humanize.downcase
+      should "#{action} a #{human_name}", :before => before do
+        assert_equal @_before_change_record_count + amount,
+          klass.count,
+          "Expected to #{action} a #{human_name}"
+      end
+    end
+
+    # Returns the values for the entries in the args hash who's keys are listed in the wanted array.
+    # Will raise if there are keys in the args hash that aren't listed.
+    def shoulda_get_options!(args, *wanted)
+      ret  = []
+      opts = (args.last.is_a?(Hash) ? args.pop : {})
+      wanted.each {|w| ret << opts.delete(w)}
+      raise ArgumentError, "Unsupported options given: #{opts.keys.join(', ')}" unless opts.keys.empty?
+      return wanted.size == 1 ? ret.first : ret
+    end
+  end
+end
+
+Test::Unit::TestCase.send :extend, Shoulda::ChangeMatchers

data/shoulda-change_matchers.gemspec

@@ -0,0 +1,10 @@
+name = "shoulda-change_matchers"
+
+Gem::Specification.new name, "0.0.1" do |s|
+  s.summary = "should_change / should_create / should_destroy matchers for shoulda 3 backported from shoulda 2"
+  s.authors = ["Michael Grosser"]
+  s.email = "michael@grosser.it"
+  s.homepage = "http://github.com/grosser/#{name}"
+  s.files = `git ls-files`.split("\n")
+  s.license = "MIT"
+end

data/test/shoulda_change_matchers_test.rb

@@ -0,0 +1,44 @@
+require "test/unit"
+require "shoulda"
+$LOAD_PATH.unshift File.expand_path("../../lib", __FILE__)
+#require "shoulda/change_matchers"
+
+# simulate active_support being here ...
+class String
+  def camelize
+    "User"
+  end
+
+  def constantize
+    eval self
+  end
+
+  def humanize
+    camelize
+  end
+end
+
+class User
+  class << self
+    attr_accessor :count
+
+    def create!
+      self.count += 1
+    end
+
+    def delete_all
+      self.count = 0
+    end
+  end
+end
+
+class ShouldaLetTest < Test::Unit::TestCase
+  setup do
+    User.count = 1
+  end
+
+  context "Readme" do
+    example = File.read(File.expand_path("../../Readme.md", __FILE__)).match(/<!-- example -->(.*)<!-- example -->/m)[1]
+    eval example
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: shoulda-change_matchers
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Michael Grosser
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-08-31 00:00:00.000000000 Z
+dependencies: []
+description: 
+email: michael@grosser.it
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .travis.yml
+- Appraisals
+- Gemfile
+- Gemfile.lock
+- Rakefile
+- Readme.md
+- gemfiles/shoulda2.gemfile
+- gemfiles/shoulda2.gemfile.lock
+- gemfiles/shoulda3.gemfile
+- gemfiles/shoulda3.gemfile.lock
+- lib/shoulda/change_matchers.rb
+- shoulda-change_matchers.gemspec
+- test/shoulda_change_matchers_test.rb
+homepage: http://github.com/grosser/shoulda-change_matchers
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3014986726780787426
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 3014986726780787426
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: should_change / should_create / should_destroy matchers for shoulda 3 backported
+  from shoulda 2
+test_files: []