micronaut 0.2.9

data/examples/lib/micronaut/formatters/documentation_formatter_example.rb

@@ -0,0 +1,5 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+describe Micronaut::Formatters::DocumentationFormatter do
+  
+end

data/examples/lib/micronaut/formatters/progress_formatter_example.rb

@@ -0,0 +1,29 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+describe Micronaut::Formatters::ProgressFormatter do
+  
+   before do
+     @output = StringIO.new
+     @formatter = Micronaut::Formatters::ProgressFormatter.new
+     @formatter.start(2)
+     @formatter.stubs(:color_enabled?).returns(false)
+     @formatter.stubs(:output).returns(@output)
+   end
+   
+   it "should produce line break on start dump" do
+     @formatter.start_dump(3)
+     @output.string.should == "\n"
+   end
+   
+   it "should produce standard summary without pending when pending has a 0 count" do
+     @formatter.start_dump(3)
+     @formatter.dump_summary
+     @output.string.should =~ /Finished in 3 seconds\n2 examples/i
+   end
+   
+   it "should push nothing on start" do
+     @formatter.start(4)
+     @output.string.should == ""
+   end
+   
+end

data/examples/lib/micronaut/kernel_extensions_example.rb

@@ -0,0 +1,13 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../example_helper")
+
+describe Micronaut::KernelExtensions do
+  
+  it "should be included in Object" do
+    Object.included_modules.should include(Micronaut::KernelExtensions)
+  end
+  
+  it "should add a describe method to Object" do
+    Object.should respond_to(:describe)
+  end
+
+end

data/examples/lib/micronaut/matchers/be_close_example.rb

@@ -0,0 +1,52 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+describe Micronaut::Matchers do
+
+  describe "be_close" do
+
+    it "should match when value == target" do
+      be_close(5.0, 0.5).matches?(5.0).should be_true
+    end
+
+    it "should match when value < (target + delta)" do
+      be_close(5.0, 0.5).matches?(5.49).should be_true
+    end
+
+    it "should match when value > (target - delta)" do
+      be_close(5.0, 0.5).matches?(4.51).should be_true
+    end
+
+    it "should not match when value == (target - delta)" do
+      be_close(5.0, 0.5).matches?(4.5).should be_false
+    end
+
+    it "should not match when value < (target - delta)" do
+      be_close(5.0, 0.5).matches?(4.49).should be_false
+    end
+
+    it "should not match when value == (target + delta)" do
+      be_close(5.0, 0.5).matches?(5.5).should be_false
+    end
+
+    it "should not match when value > (target + delta)" do
+      be_close(5.0, 0.5).matches?(5.51).should be_false
+    end
+
+    it "should provide a useful failure message" do
+      #given
+      matcher = be_close(5.0, 0.5)
+      #when
+      matcher.matches?(5.51)
+      #then
+      matcher.failure_message.should == "expected 5.0 +/- (< 0.5), got 5.51"
+    end
+
+    it "should describe itself" do
+      matcher = be_close(5.0, 0.5)
+      matcher.matches?(5.1)
+      matcher.description.should == "be close to 5.0 (within +- 0.5)"
+    end
+
+  end
+
+end

data/examples/lib/micronaut/matchers/be_example.rb

@@ -0,0 +1,298 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+describe Micronaut::Matchers do
+
+  describe "should be_predicate" do  
+
+    it "should pass when actual returns true for :predicate?" do
+      actual = stub("actual", :happy? => true)
+      actual.should be_happy
+    end
+
+    it "should pass when actual returns true for :predicates? (present tense)" do
+      actual = stub("actual", :exists? => true, :exist? => true)
+      actual.should be_exist
+    end
+
+    it "should fail when actual returns false for :predicate?" do
+      actual = stub("actual", :happy? => false)
+      lambda do
+        actual.should be_happy
+      end.should fail_with("expected happy? to return true, got false")
+    end
+
+    it "should fail when actual does not respond to :predicate?" do
+      lambda do
+        Object.new.should be_happy
+      end.should raise_error(NameError, /happy\?/)
+    end
+
+    it "should fail on error other than NameError" do
+      actual = stub("actual")
+      actual.expects(:foo?).raises("aaaah")
+      lambda do
+        actual.should be_foo
+      end.should raise_error(/aaaah/)
+    end
+
+    it "should fail on error other than NameError (with the present tense predicate)" do
+      actual = Object.new
+      actual.expects(:foos?).raises("aaaah")
+      lambda do
+        actual.should be_foo
+      end.should raise_error(/aaaah/)
+    end
+
+  end
+
+  describe "should_not be_predicate" do
+
+    it "should pass when actual returns false for :sym?" do
+      actual = stub("actual", :happy? => false)
+      actual.should_not be_happy
+    end
+
+    it "should fail when actual returns true for :sym?" do
+      actual = stub("actual", :happy? => true)
+      lambda do
+        actual.should_not be_happy
+      end.should fail_with("expected happy? to return false, got true")
+    end
+
+    it "should fail when actual does not respond to :sym?" do
+      lambda do
+        Object.new.should_not be_happy
+      end.should raise_error(NameError)
+    end
+
+  end
+
+  describe "should be_predicate(*args)" do
+
+    it "should pass when actual returns true for :predicate?(*args)" do
+      actual = mock("actual")
+      actual.expects(:older_than?).with(3).returns(true)
+      actual.should be_older_than(3)
+    end
+
+    it "should fail when actual returns false for :predicate?(*args)" do
+      actual = mock("actual")
+      actual.expects(:older_than?).with(3).returns(false)
+      lambda do
+        actual.should be_older_than(3)
+      end.should fail_with("expected older_than?(3) to return true, got false")
+    end
+
+    it "should fail when actual does not respond to :predicate?" do
+      lambda do
+        Object.new.should be_older_than(3)
+      end.should raise_error(NameError)
+    end
+
+  end
+
+  describe "should_not be_predicate(*args)" do
+
+    it "should pass when actual returns false for :predicate?(*args)" do
+      actual = mock("actual")
+      actual.expects(:older_than?).with(3).returns(false)
+      actual.should_not be_older_than(3)
+    end
+
+    it "should fail when actual returns true for :predicate?(*args)" do
+      actual = mock("actual")
+      actual.expects(:older_than?).with(3).returns(true)
+      lambda do
+        actual.should_not be_older_than(3)
+      end.should fail_with("expected older_than?(3) to return false, got true")
+    end
+
+    it "should fail when actual does not respond to :predicate?" do
+      lambda do
+        Object.new.should_not be_older_than(3)
+      end.should raise_error(NameError)
+    end
+
+  end
+
+  describe "should be_true" do
+
+    it "should pass when actual equal(true)" do
+      true.should be_true
+    end
+
+    it "should fail when actual equal(false)" do
+      lambda do
+        false.should be_true
+      end.should fail_with("expected true, got false")
+    end
+
+  end
+
+  describe "should be_false" do
+
+    it "should pass when actual equal(false)" do
+      false.should be_false
+    end
+
+    it "should fail when actual equal(true)" do
+      lambda do
+        true.should be_false
+      end.should fail_with("expected false, got true")
+    end
+
+  end
+
+  describe "should be_nil" do
+
+    it "should pass when actual is nil" do
+      nil.should be_nil
+    end
+
+    it "should fail when actual is not nil" do
+      lambda do
+        :not_nil.should be_nil
+      end.should fail_with("expected nil? to return true, got false")
+    end
+
+  end
+
+  describe "should_not be_nil" do
+
+    it "should pass when actual is not nil" do
+      :not_nil.should_not be_nil
+    end
+
+    it "should fail when actual is nil" do
+      lambda do
+        nil.should_not be_nil
+      end.should fail_with("expected nil? to return false, got true")
+    end
+
+  end
+
+  describe "should be <" do
+
+    it "should pass when < operator returns true" do
+      3.should be < 4
+    end
+
+    it "should fail when < operator returns false" do
+      lambda { 3.should be < 3 }.should fail_with("expected < 3, got 3")
+    end
+
+  end
+
+  describe "should be <=" do
+
+    it "should pass when <= operator returns true" do
+      3.should be <= 4
+      4.should be <= 4
+    end
+
+    it "should fail when <= operator returns false" do
+      lambda { 3.should be <= 2 }.should fail_with("expected <= 2, got 3")
+    end
+
+  end
+
+  describe "should be >=" do
+
+    it "should pass when >= operator returns true" do
+      4.should be >= 4
+      5.should be >= 4
+    end
+
+    it "should fail when >= operator returns false" do
+      lambda { 3.should be >= 4 }.should fail_with("expected >= 4, got 3")
+    end
+
+  end
+
+  describe "should be >" do
+
+    it "should pass when > operator returns true" do
+      5.should be > 4
+    end
+
+    it "should fail when > operator returns false" do
+      lambda { 3.should be > 4 }.should fail_with("expected > 4, got 3")
+    end
+
+  end
+
+  describe "should be ==" do
+
+    it "should pass when == operator returns true" do
+      5.should be == 5
+    end
+
+    it "should fail when == operator returns false" do
+      lambda { 3.should be == 4 }.should fail_with("expected == 4, got 3")
+    end
+
+  end
+
+  describe "should be ===" do
+
+    it "should pass when === operator returns true" do
+      Hash.should be === Hash.new
+    end
+
+    it "should fail when === operator returns false" do
+      lambda { Hash.should be === "not a hash" }.should fail_with(%[expected === not a hash, got Hash])
+    end
+
+  end
+
+  describe "should_not with operators" do
+
+    it "should coach user to stop using operators with should_not" do
+      lambda do
+        5.should_not be < 6
+      end.should raise_error(/not only FAILED,\nit reads really poorly./m)
+    end
+
+  end
+
+  describe "should be" do
+
+    it "should pass if actual is true or a set value" do
+      true.should be
+      1.should be
+    end
+
+    it "should fail if actual is false" do
+      lambda {false.should be}.should fail_with("expected true, got false")
+    end
+
+    it "should fail if actual is nil" do
+      lambda {nil.should be}.should fail_with("expected true, got nil")
+    end
+
+  end
+
+  describe "should be(value)" do
+
+    it "should pass if actual.equal?(value)" do
+      5.should be(5)
+    end
+
+    it "should fail if !actual.equal?(value)" do
+      lambda { 5.should be(6) }.should fail_with("expected 6, got 5")
+    end
+
+  end
+
+  describe "'should be' with operator" do
+
+    it "should include 'be' in the description" do
+      (be > 6).description.should =~ /be > 6/
+      (be >= 6).description.should =~ /be >= 6/
+      (be <= 6).description.should =~ /be <= 6/
+      (be < 6).description.should =~ /be < 6/
+    end
+
+  end
+
+end

data/examples/lib/micronaut/matchers/change_example.rb

@@ -0,0 +1,360 @@
+#Based on patch from Wilson Bilkovich
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+class SomethingExpected
+  attr_accessor :some_value
+end
+
+describe Micronaut::Matchers do
+
+  describe "should change(actual, message)" do
+    
+    before do
+      @instance = SomethingExpected.new
+      @instance.some_value = 5
+    end
+
+    it "should pass when actual is modified by the block" do
+      lambda {@instance.some_value = 6}.should change(@instance, :some_value)
+    end
+
+    it "should fail when actual is not modified by the block" do
+      lambda do
+        lambda {}.should change(@instance, :some_value)
+      end.should fail_with("some_value should have changed, but is still 5")
+    end
+    
+  end
+
+  describe "should_not change(actual, message)" do
+    
+    before do
+      @instance = SomethingExpected.new
+      @instance.some_value = 5
+    end
+
+    it "should pass when actual is not modified by the block" do
+      lambda { }.should_not change(@instance, :some_value)
+    end
+
+    it "should fail when actual is not modified by the block" do
+      lambda do
+        lambda {@instance.some_value = 6}.should_not change(@instance, :some_value)
+      end.should fail_with("some_value should not have changed, but did change from 5 to 6")
+    end
+    
+  end
+
+  describe "should change { block }" do
+    
+    before do
+      @instance = SomethingExpected.new
+      @instance.some_value = 5
+    end
+
+    it "should pass when actual is modified by the block" do
+      lambda {@instance.some_value = 6}.should change { @instance.some_value }
+    end
+
+    it "should fail when actual is not modified by the block" do
+      lambda do
+        lambda {}.should change{ @instance.some_value }
+      end.should fail_with("result should have changed, but is still 5")
+    end
+
+    it "should warn if passed a block using do/end instead of {}" do
+      lambda do
+        lambda {}.should change do; end
+      end.should raise_error(Micronaut::Matchers::MatcherError, /block passed to should or should_not/)
+    end
+    
+  end
+
+  describe "should_not change { block }" do
+    
+    before do
+      @instance = SomethingExpected.new
+      @instance.some_value = 5
+    end
+
+    it "should pass when actual is modified by the block" do
+      lambda {}.should_not change{ @instance.some_value }
+    end
+
+    it "should fail when actual is not modified by the block" do
+      lambda do
+        lambda {@instance.some_value = 6}.should_not change { @instance.some_value }
+      end.should fail_with("result should not have changed, but did change from 5 to 6")
+    end
+
+    it "should warn if passed a block using do/end instead of {}" do
+      lambda do
+        lambda {}.should_not change do; end
+      end.should raise_error(Micronaut::Matchers::MatcherError, /block passed to should or should_not/)
+    end
+    
+  end
+
+  describe "should change(actual, message).by(expected)" do
+    
+    before do
+      @instance = SomethingExpected.new
+      @instance.some_value = 5
+    end
+
+    it "should pass when attribute is changed by expected amount" do
+      lambda { @instance.some_value += 1 }.should change(@instance, :some_value).by(1)
+    end
+
+    it "should fail when the attribute is changed by unexpected amount" do
+      lambda do
+        lambda { @instance.some_value += 2 }.should change(@instance, :some_value).by(1)
+      end.should fail_with("some_value should have been changed by 1, but was changed by 2")
+    end
+
+    it "should fail when the attribute is changed by unexpected amount in the opposite direction" do
+      lambda do
+        lambda { @instance.some_value -= 1 }.should change(@instance, :some_value).by(1)
+      end.should 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 do
+      @instance = SomethingExpected.new
+      @instance.some_value = 5
+    end
+
+    it "should pass when attribute is changed by expected amount" do
+      lambda { @instance.some_value += 1 }.should change{@instance.some_value}.by(1)
+    end
+
+    it "should fail when the attribute is changed by unexpected amount" do
+      lambda do
+        lambda { @instance.some_value += 2 }.should change{@instance.some_value}.by(1)
+      end.should fail_with("result should have been changed by 1, but was changed by 2")
+    end
+
+    it "should fail when the attribute is changed by unexpected amount in the opposite direction" do
+      lambda do
+        lambda { @instance.some_value -= 1 }.should change{@instance.some_value}.by(1)
+      end.should 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 do
+      @instance = SomethingExpected.new
+      @instance.some_value = 5
+    end
+
+    it "should pass when attribute is changed by greater than the expected amount" do
+      lambda { @instance.some_value += 2 }.should change(@instance, :some_value).by_at_least(1)
+    end
+
+    it "should pass when attribute is changed by the expected amount" do
+      lambda { @instance.some_value += 2 }.should change(@instance, :some_value).by_at_least(2)
+    end  
+
+    it "should fail when the attribute is changed by less than the expected amount" do
+      lambda do
+        lambda { @instance.some_value += 1 }.should change(@instance, :some_value).by_at_least(2)
+      end.should 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 do
+      @instance = SomethingExpected.new
+      @instance.some_value = 5
+    end
+
+    it "should pass when attribute is changed by greater than expected amount" do
+      lambda { @instance.some_value += 2 }.should change{@instance.some_value}.by_at_least(1)
+    end
+
+    it "should pass when attribute is changed by the expected amount" do
+      lambda { @instance.some_value += 2 }.should change{@instance.some_value}.by_at_least(2)
+    end  
+
+    it "should fail when the attribute is changed by less than the unexpected amount" do
+      lambda do
+        lambda { @instance.some_value += 1 }.should change{@instance.some_value}.by_at_least(2)
+      end.should 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 do
+      @instance = SomethingExpected.new
+      @instance.some_value = 5
+    end
+
+    it "should pass when attribute is changed by less than the expected amount" do
+      lambda { @instance.some_value += 2 }.should change(@instance, :some_value).by_at_most(3)
+    end
+
+    it "should pass when attribute is changed by the expected amount" do
+      lambda { @instance.some_value += 2 }.should change(@instance, :some_value).by_at_most(2)
+    end  
+
+    it "should fail when the attribute is changed by greater than the expected amount" do
+      lambda do
+        lambda { @instance.some_value += 2 }.should change(@instance, :some_value).by_at_most(1)
+      end.should 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 do
+      @instance = SomethingExpected.new
+      @instance.some_value = 5
+    end
+
+    it "should pass when attribute is changed by less than expected amount" do
+      lambda { @instance.some_value += 2 }.should change{@instance.some_value}.by_at_most(3)
+    end
+
+    it "should pass when attribute is changed by the expected amount" do
+      lambda { @instance.some_value += 2 }.should change{@instance.some_value}.by_at_most(2)
+    end  
+
+    it "should fail when the attribute is changed by greater than the unexpected amount" do
+      lambda do
+        lambda { @instance.some_value += 2 }.should change{@instance.some_value}.by_at_most(1)
+      end.should 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
+    
+    before do
+      @instance = SomethingExpected.new
+      @instance.some_value = 'string'
+    end
+
+    it "should pass when attribute is == to expected value before executing block" do
+      lambda { @instance.some_value = "astring" }.should change(@instance, :some_value).from("string")
+    end
+
+    it "should fail when attribute is not == to expected value before executing block" do
+      lambda do
+        lambda { @instance.some_value = "knot" }.should change(@instance, :some_value).from("cat")
+      end.should fail_with("some_value should have initially been \"cat\", but was \"string\"")
+    end
+    
+  end
+
+  describe "should change{ block }.from(old)" do
+    
+    before do
+      @instance = SomethingExpected.new
+      @instance.some_value = 'string'
+    end
+
+    it "should pass when attribute is == to expected value before executing block" do
+      lambda { @instance.some_value = "astring" }.should change{@instance.some_value}.from("string")
+    end
+
+    it "should fail when attribute is not == to expected value before executing block" do
+      lambda do
+        lambda { @instance.some_value = "knot" }.should change{@instance.some_value}.from("cat")
+      end.should fail_with("result should have initially been \"cat\", but was \"string\"")
+    end
+    
+  end
+
+  describe "should change(actual, message).to(new)" do
+    
+    before do
+      @instance = SomethingExpected.new
+      @instance.some_value = 'string'
+    end
+
+    it "should pass when attribute is == to expected value after executing block" do
+      lambda { @instance.some_value = "cat" }.should change(@instance, :some_value).to("cat")
+    end
+
+    it "should fail when attribute is not == to expected value after executing block" do
+      lambda do
+        lambda { @instance.some_value = "cat" }.should change(@instance, :some_value).from("string").to("dog")
+      end.should fail_with("some_value should have been changed to \"dog\", but is now \"cat\"")
+    end
+    
+  end
+
+  describe "should change{ block }.to(new)" do
+    
+    before do
+      @instance = SomethingExpected.new
+      @instance.some_value = 'string'
+    end
+
+    it "should pass when attribute is == to expected value after executing block" do
+      lambda { @instance.some_value = "cat" }.should change{@instance.some_value}.to("cat")
+    end
+
+    it "should fail when attribute is not == to expected value after executing block" do
+      lambda do
+        lambda { @instance.some_value = "cat" }.should change{@instance.some_value}.from("string").to("dog")
+      end.should 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 do
+      @instance = SomethingExpected.new
+      @instance.some_value = 'string'
+    end
+
+    it "should pass when #to comes before #from" do
+      lambda { @instance.some_value = "cat" }.should change(@instance, :some_value).to("cat").from("string")
+    end
+
+    it "should pass when #from comes before #to" do
+      lambda { @instance.some_value = "cat" }.should change(@instance, :some_value).from("string").to("cat")
+    end
+    
+  end
+
+  describe "should change{ block }.from(old).to(new)" do
+    
+    before do
+      @instance = SomethingExpected.new
+      @instance.some_value = 'string'
+    end
+
+    it "should pass when #to comes before #from" do
+      lambda { @instance.some_value = "cat" }.should change{@instance.some_value}.to("cat").from("string")
+    end
+
+    it "should pass when #from comes before #to" do
+      lambda { @instance.some_value = "cat" }.should change{@instance.some_value}.from("string").to("cat")
+    end
+    
+  end
+
+  it "should work 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
+
+    lambda do
+      lambda { @instance.some_value = "cat" }.should change(@instance, :some_value)
+    end.should_not raise_error
+  end
+
+end