# -*- encoding: utf-8 -*- # Copyright © 2010, 2011, José Pablo Fernández module AssertDifference VERSION = "0.3.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. # # assert_difference "Article.count" do # post :create, :article => {...} # end # # An arbitrary expression is passed in and evaluated. # # assert_difference "assigns(:article).comments(:reload).size" do # post :create, :comment => {...} # end # # An arbitrary positive or negative difference can be specified. The default is +1. # # assert_difference "Article.count", -1 do # post :delete, :id => ... # end # # An array of expressions can also be passed in and evaluated. # # assert_difference [ "Article.count", "Post.count" ], +2 do # post :create, :article => {...} # end # # A error message can be specified. # # assert_difference "Article.count", -1, "An Article should be destroyed" do # post :delete, :id => ... # end # # Various assertions can be combined into one, instead of writing: # # assert_difference "Company.count" do # assert_difference "User.count", +5 do # assert_difference "Article.count", -1 do # post :something # end # end # end # # you can *now* write: # # assert_difference "Article.count" => 1, "assigns(:article).comments(:reload).size" => 1, "Article.count" => -1 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 [String, nil] message error message to display. One would be constructed if nil. def assert_difference(expressions, 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 } end before = {} expressions.each { |exp, _| before[exp] = eval(exp, b) } yield expressions.each do |exp, diff| error = "#{exp.inspect} didn't change by #{diff}" error = "#{message}.\n#{error}" if message assert_equal(before[exp] + diff, eval(exp, b), error) end end end