assert_difference 0.4.2 → 0.5.0

data/README.md

@@ -22,6 +22,14 @@ would require a more verbose syntax:
       end
     end
 
+Expectations can also be ranges, for example:
+
+    assert_difference "Blog.count" => +1, "Post.count" => 2..5 do # Generate some sample posts when creating a blog
+      post :create
+    end
+
+On top of that, error reporting is improved by displaying all the counters that didn't match except only one.
+
 To use it with Test::Unit add this code:
 
     class Test::Unit::TestCase

data/assert_difference.gemspec

@@ -11,8 +11,8 @@ Gem::Specification.new do |s|
   s.authors = ["J. Pablo Fernández"]
   s.email = ["pupeno@pupeno.com"]
   s.homepage = "http://pupeno.github.com/assert_difference/"
-  s.summary = "An improved assert_difference"
-  s.description = "Better assert_difference than Rails by providing a more compact and readable syntax through hashes. For some more information read http://pupeno.com/blog/better-assert-difference."
+  s.summary = "Like Rails' assert_difference, but more powerful"
+  s.description = "Like Rails' assert_difference, but more compact and readable syntax through hashes, testing ranges and improved error reporting."
 
   s.required_rubygems_version = ">= 1.3.6"
   s.rubyforge_project = "assert_difference"

data/lib/assert_difference.rb

@@ -2,7 +2,7 @@
 # Copyright © 2010, 2011, 2012 José Pablo Fernández
 
 module AssertDifference
-  VERSION = "0.4.2" unless defined?(::AssertDifference::VERSION)
+  VERSION = "0.5.0" unless defined?(::AssertDifference::VERSION)
 
   # Test numeric difference between the return value of an expression as a result of what is evaluated
   # in the yielded block.
@@ -58,17 +58,23 @@ module AssertDifference
   #     end
   #     assert_equal [@user.email], email.to
   #
+  # the expectations can also be ranges, for example:
+  #
+  #     assert_difference "Article.count" => 1, "sample_coments.count" => 2..4 do
+  #       post :something
+  #     end
+  #
   # @param [Array, Hash] expressions array of expressions to evaluate or hash
   #   table of expressions and expected difference.
-  # @param [Integer] difference expected difference when using an array or single expression.
+  # @param [Integer or Range] expected_difference expected difference when using an array or single expression.
   # @param [String, nil] message error message to display. One would be constructed if nil.
   # @return whatever the block returned
-  def assert_difference(expressions, difference = 1, message = nil, &block)
+  def assert_difference(expressions, expected_difference = 1, message = nil, &block)
     b = block.send(:binding)
     if !expressions.is_a? Hash
       exps = Array.wrap(expressions)
       expressions = {}
-      exps.each { |e| expressions[e] = difference }
+      exps.each { |e| expressions[e] = expected_difference }
     end
 
     before = {}
@@ -78,9 +84,13 @@ module AssertDifference
 
     error_messages = []
     expressions.each do |exp, diff|
-      expected = before[exp] + diff
+      expected = if diff.is_a? Range
+                   (before[exp] + diff.first)..(before[exp] + diff.end)
+                 else
+                   before[exp] + diff
+                 end
       actual = eval(exp, b)
-      if expected != actual
+      if expected.is_a?(Range) ? !expected.include?(actual) : expected != actual
         error = "#{exp.inspect} didn't change by #{diff} (expecting #{expected}, but got #{actual})"
         error = "#{message}.\n#{error}" if message
         error_messages << error

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: assert_difference
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.5.0
   prerelease: 
 platform: ruby
 authors:
@@ -27,8 +27,8 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: Better assert_difference than Rails by providing a more compact and readable
-  syntax through hashes. For some more information read http://pupeno.com/blog/better-assert-difference.
+description: Like Rails' assert_difference, but more compact and readable syntax through
+  hashes, testing ranges and improved error reporting.
 email:
 - pupeno@pupeno.com
 executables: []
@@ -67,6 +67,6 @@ rubyforge_project: assert_difference
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
-summary: An improved assert_difference
+summary: Like Rails' assert_difference, but more powerful
 test_files: []
 has_rdoc: