#Based on patch from Wilson Bilkovich require 'spec_helper' class SomethingExpected attr_accessor :some_value end describe "should change(actual, message)" do context "with a numeric value" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 5 end it "passes when actual is modified by the block" do expect {@instance.some_value = 6.0}.to change(@instance, :some_value) end it "fails when actual is not modified by the block" do expect do expect {}.to change(@instance, :some_value) end.to fail_with("some_value should have changed, but is still 5") end it "provides a #description" do change(@instance, :some_value).description.should == "change #some_value" end end context "with boolean values" do before(:each) do @instance = SomethingExpected.new @instance.some_value = true end it "passes when actual is modified by the block" do expect {@instance.some_value = false}.to change(@instance, :some_value) end it "fails when actual is not modified by the block" do expect do expect {}.to change(@instance, :some_value) end.to fail_with("some_value should have changed, but is still true") end end context "with nil value" do before(:each) do @instance = SomethingExpected.new @instance.some_value = nil end it "passes when actual is modified by the block" do expect {@instance.some_value = false}.to change(@instance, :some_value) end it "fails when actual is not modified by the block" do expect do expect {}.to change(@instance, :some_value) end.to fail_with("some_value should have changed, but is still nil") end end context "with an array" do before(:each) do @instance = SomethingExpected.new @instance.some_value = [] end it "passes when actual is modified by the block" do expect {@instance.some_value << 1}.to change(@instance, :some_value) end it "fails when actual is not modified by the block" do expect do expect {}.to change(@instance, :some_value) end.to fail_with("some_value should have changed, but is still []") end end context "with a hash" do before(:each) do @instance = SomethingExpected.new @instance.some_value = {:a => 'a'} end it "passes when actual is modified by the block" do expect {@instance.some_value[:a] = 'A'}.to change(@instance, :some_value) end it "fails when actual is not modified by the block" do expect do expect {}.to change(@instance, :some_value) end.to fail end end context "with an arbitrary enumerable" do before(:each) do @instance = SomethingExpected.new @instance.some_value = Class.new do include Enumerable attr_reader :elements def initialize(*elements) @elements = elements.dup end def <<(element) elements << element end def dup self.class.new *elements end def ==(other) elements == other.elements end end.new end it "passes when actual is modified by the block" do expect {@instance.some_value << 1}.to change(@instance, :some_value) end it "fails when actual is not modified by the block" do expect do expect {}.to change(@instance, :some_value) end.to fail_with(/^some_value should have changed, but is still/) end end end describe "should_not change(actual, message)" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 5 end it "passes when actual is not modified by the block" do expect { }.to_not change(@instance, :some_value) end it "fails when actual is not modified by the block" do expect do expect {@instance.some_value = 6}.to_not change(@instance, :some_value) end.to fail_with("some_value should not have changed, but did change from 5 to 6") end end describe "should change { block }" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 5 end it "passes when actual is modified by the block" do expect {@instance.some_value = 6}.to change { @instance.some_value } end it "fails when actual is not modified by the block" do expect do expect {}.to change{ @instance.some_value } end.to fail_with("result should have changed, but is still 5") end it "warns if passed a block using do/end instead of {}" do expect do expect {}.to change do; end end.to raise_error(RSpec::Matchers::MatcherError, /block passed to should or should_not/) end it "provides a #description" do change { @instance.some_value }.description.should == "change #result" end end describe "should_not change { block }" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 5 end it "passes when actual is modified by the block" do expect {}.to_not change{ @instance.some_value } end it "fails when actual is not modified by the block" do expect do expect {@instance.some_value = 6}.to_not change { @instance.some_value } end.to fail_with("result should not have changed, but did change from 5 to 6") end it "warns if passed a block using do/end instead of {}" do expect do expect {}.to_not change do; end end.to raise_error(RSpec::Matchers::MatcherError, /block passed to should or should_not/) end end describe "should change(actual, message).by(expected)" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 5 end it "passes when attribute is changed by expected amount" do expect { @instance.some_value += 1 }.to change(@instance, :some_value).by(1) end it "passes when attribute is not changed and expected amount is 0" do expect { @instance.some_value += 0 }.to change(@instance, :some_value).by(0) end it "fails when the attribute is changed by unexpected amount" do expect do expect { @instance.some_value += 2 }.to change(@instance, :some_value).by(1) end.to fail_with("some_value should have been changed by 1, but was changed by 2") end it "fails when the attribute is changed by unexpected amount in the opposite direction" do expect do expect { @instance.some_value -= 1 }.to change(@instance, :some_value).by(1) end.to fail_with("some_value should have been changed by 1, but was changed by -1") end end describe "should change{ block }.by(expected)" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 5 end it "passes when attribute is changed by expected amount" do expect { @instance.some_value += 1 }.to change{@instance.some_value}.by(1) end it "fails when the attribute is changed by unexpected amount" do expect do expect { @instance.some_value += 2 }.to change{@instance.some_value}.by(1) end.to fail_with("result should have been changed by 1, but was changed by 2") end it "fails when the attribute is changed by unexpected amount in the opposite direction" do expect do expect { @instance.some_value -= 1 }.to change{@instance.some_value}.by(1) end.to fail_with("result should have been changed by 1, but was changed by -1") end end describe "should change(actual, message).by_at_least(expected)" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 5 end it "passes when attribute is changed by greater than the expected amount" do expect { @instance.some_value += 2 }.to change(@instance, :some_value).by_at_least(1) end it "passes when attribute is changed by the expected amount" do expect { @instance.some_value += 2 }.to change(@instance, :some_value).by_at_least(2) end it "fails when the attribute is changed by less than the expected amount" do expect do expect { @instance.some_value += 1 }.to change(@instance, :some_value).by_at_least(2) end.to fail_with("some_value should have been changed by at least 2, but was changed by 1") end end describe "should change{ block }.by_at_least(expected)" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 5 end it "passes when attribute is changed by greater than expected amount" do expect { @instance.some_value += 2 }.to change{@instance.some_value}.by_at_least(1) end it "passes when attribute is changed by the expected amount" do expect { @instance.some_value += 2 }.to change{@instance.some_value}.by_at_least(2) end it "fails when the attribute is changed by less than the unexpected amount" do expect do expect { @instance.some_value += 1 }.to change{@instance.some_value}.by_at_least(2) end.to fail_with("result should have been changed by at least 2, but was changed by 1") end end describe "should change(actual, message).by_at_most(expected)" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 5 end it "passes when attribute is changed by less than the expected amount" do expect { @instance.some_value += 2 }.to change(@instance, :some_value).by_at_most(3) end it "passes when attribute is changed by the expected amount" do expect { @instance.some_value += 2 }.to change(@instance, :some_value).by_at_most(2) end it "fails when the attribute is changed by greater than the expected amount" do expect do expect { @instance.some_value += 2 }.to change(@instance, :some_value).by_at_most(1) end.to fail_with("some_value should have been changed by at most 1, but was changed by 2") end end describe "should change{ block }.by_at_most(expected)" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 5 end it "passes when attribute is changed by less than expected amount" do expect { @instance.some_value += 2 }.to change{@instance.some_value}.by_at_most(3) end it "passes when attribute is changed by the expected amount" do expect { @instance.some_value += 2 }.to change{@instance.some_value}.by_at_most(2) end it "fails when the attribute is changed by greater than the unexpected amount" do expect do expect { @instance.some_value += 2 }.to change{@instance.some_value}.by_at_most(1) end.to fail_with("result should have been changed by at most 1, but was changed by 2") end end describe "should change(actual, message).from(old)" do context "with boolean values" do before(:each) do @instance = SomethingExpected.new @instance.some_value = true end it "passes when attribute is == to expected value before executing block" do expect { @instance.some_value = false }.to change(@instance, :some_value).from(true) end it "fails when attribute is not == to expected value before executing block" do expect do expect { @instance.some_value = 'foo' }.to change(@instance, :some_value).from(false) end.to fail_with("some_value should have initially been false, but was true") end end context "with non-boolean values" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 'string' end it "passes when attribute is === to expected value before executing block" do expect { @instance.some_value = "astring" }.to change(@instance, :some_value).from("string") end it "compares the expected and actual values with ===" do expected = "string" expected.should_receive(:===).and_return true expect { @instance.some_value = "astring" }.to change(@instance, :some_value).from(expected) end it "fails when attribute is not === to expected value before executing block" do expect do expect { @instance.some_value = "knot" }.to change(@instance, :some_value).from("cat") end.to fail_with("some_value should have initially been \"cat\", but was \"string\"") end end end describe "should change{ block }.from(old)" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 'string' end it "passes when attribute is === to expected value before executing block" do expect { @instance.some_value = "astring" }.to change{@instance.some_value}.from("string") end it "compares the expected and actual values with ===" do expected = "string" expected.should_receive(:===).and_return true expect { @instance.some_value = "astring" }.to change{@instance.some_value}.from(expected) end it "fails when attribute is not === to expected value before executing block" do expect do expect { @instance.some_value = "knot" }.to change{@instance.some_value}.from("cat") end.to fail_with("result should have initially been \"cat\", but was \"string\"") end end describe "should change(actual, message).to(new)" do context "with boolean values" do before(:each) do @instance = SomethingExpected.new @instance.some_value = true end it "passes when attribute is == to expected value after executing block" do expect { @instance.some_value = false }.to change(@instance, :some_value).to(false) end it "fails when attribute is not == to expected value after executing block" do expect do expect { @instance.some_value = 1 }.to change(@instance, :some_value).from(true).to(false) end.to fail_with("some_value should have been changed to false, but is now 1") end end context "with non-boolean values" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 'string' end it "passes when attribute is === to expected value after executing block" do expect { @instance.some_value = "cat" }.to change(@instance, :some_value).to("cat") end it "compares the expected and actual values with ===" do expected = "cat" expected.should_receive(:===).and_return true expect { @instance.some_value = "cat" }.to change(@instance, :some_value).to(expected) end it "fails when attribute is not === to expected value after executing block" do expect do expect { @instance.some_value = "cat" }.to change(@instance, :some_value).from("string").to("dog") end.to fail_with("some_value should have been changed to \"dog\", but is now \"cat\"") end end end describe "should change{ block }.to(new)" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 'string' end it "passes when attribute is === to expected value after executing block" do expect { @instance.some_value = "cat" }.to change{@instance.some_value}.to("cat") end it "compares the expected and actual values with ===" do expected = "cat" expected.should_receive(:===).and_return true expect { @instance.some_value = "cat" }.to change{@instance.some_value}.to(expected) end it "fails when attribute is not === to expected value after executing block" do expect do expect { @instance.some_value = "cat" }.to change{@instance.some_value}.from("string").to("dog") end.to fail_with("result should have been changed to \"dog\", but is now \"cat\"") end end describe "should change(actual, message).from(old).to(new)" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 'string' end it "passes when #to comes before #from" do expect { @instance.some_value = "cat" }.to change(@instance, :some_value).to("cat").from("string") end it "passes when #from comes before #to" do expect { @instance.some_value = "cat" }.to change(@instance, :some_value).from("string").to("cat") end it "shows the correct messaging when #after and #to are different" do expect do expect { @instance.some_value = "cat" }.to change(@instance, :some_value).from("string").to("dog") end.to fail_with("some_value should have been changed to \"dog\", but is now \"cat\"") end it "shows the correct messaging when #before and #from are different" do expect do expect { @instance.some_value = "cat" }.to change(@instance, :some_value).from("not_string").to("cat") end.to fail_with("some_value should have initially been \"not_string\", but was \"string\"") end end describe "should change{ block }.from(old).to(new)" do before(:each) do @instance = SomethingExpected.new @instance.some_value = 'string' end it "passes when #to comes before #from" do expect { @instance.some_value = "cat" }.to change{@instance.some_value}.to("cat").from("string") end it "passes when #from comes before #to" do expect { @instance.some_value = "cat" }.to change{@instance.some_value}.from("string").to("cat") end end describe RSpec::Matchers::Change do it "works when the receiver has implemented #send" do @instance = SomethingExpected.new @instance.some_value = "string" def @instance.send(*args); raise "DOH! Library developers shouldn't use #send!" end expect { expect { @instance.some_value = "cat" }.to change(@instance, :some_value) }.to_not raise_error end end