micronaut 0.2.9

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

@@ -0,0 +1,103 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+describe Micronaut::Matchers do
+
+  describe "should include(expected)" do
+
+    it "should pass if target includes expected" do
+      [1,2,3].should include(3)
+      "abc".should include("a")
+    end
+
+    it 'should pass if target is a Hash and has the expected as a key' do
+      {:key => 'value'}.should include(:key)
+    end
+
+    it "should fail if target does not include expected" do
+      lambda do
+        [1,2,3].should include(4)
+      end.should fail_with("expected [1, 2, 3] to include 4")
+      lambda do
+        "abc".should include("d")
+      end.should fail_with("expected \"abc\" to include \"d\"")
+      lambda do
+        {:key => 'value'}.should include(:other)
+      end.should fail_with(%Q|expected {:key=>"value"} to include :other|)
+    end
+
+  end
+
+  describe "should include(with, multiple, args)" do
+
+    it "should pass if target includes all items" do
+      [1,2,3].should include(1,2,3)
+    end
+
+    it 'should pass if target is a Hash including all items as keys' do
+      {:key => 'value', :other => 'value'}.should include(:key, :other)
+    end
+
+    it "should fail if target does not include any one of the items" do
+      lambda do
+        [1,2,3].should include(1,2,4)
+      end.should fail_with("expected [1, 2, 3] to include 1, 2 and 4")
+    end
+
+    it 'should pass if target is a Hash missing any item as a key' do
+      lambda do
+        {:key => 'value'}.should include(:key, :other)
+      end.should fail_with(%Q|expected {:key=>"value"} to include :key and :other|)
+    end
+
+  end
+
+  describe "should_not include(expected)" do
+  
+    it "should pass if target does not include expected" do
+      [1,2,3].should_not include(4)
+      "abc".should_not include("d")
+    end
+  
+    it 'should pass if target is a Hash and does not have the expected as a key' do
+      {:other => 'value'}.should_not include(:key)
+    end
+
+    it "should fail if target includes expected" do
+      lambda {
+        [1,2,3].should_not include(3)
+      }.should fail_with("expected [1, 2, 3] not to include 3")
+      lambda {
+        "abc".should_not include("c")
+      }.should fail_with("expected \"abc\" not to include \"c\"")
+      lambda {
+        {:key => 'value'}.should_not include(:key)
+      }.should fail_with(%Q|expected {:key=>"value"} not to include :key|)
+    end
+  
+  end
+
+  describe "should include(:key => value)" do
+  
+    it "should pass if target is a Hash and includes the key/value pair" do
+      {:key => 'value'}.should include(:key => 'value')
+    end
+    
+    it "should pass if target is a Hash and includes the key/value pair among others" do
+      {:key => 'value', :other => 'different'}.should include(:key => 'value')
+    end
+    
+    it "should fail if target is a Hash and has a different value for key" do
+      lambda {
+        {:key => 'different'}.should include(:key => 'value')
+      }.should fail_with(%Q|expected {:key=>"different"} to include {:key=>"value"}|)
+    end
+    
+    it "should fail if target is a Hash and has a different key" do
+      lambda {
+        {:other => 'value'}.should include(:key => 'value')
+      }.should fail_with(%Q|expected {:other=>"value"} to include {:key=>"value"}|)
+    end
+    
+  end
+
+end

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

@@ -0,0 +1,43 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+describe Micronaut::Matchers do
+
+  describe "should match(expected)" do
+
+    it "should pass when target (String) matches expected (Regexp)" do
+      "string".should match(/tri/)
+    end
+
+    it "should fail when target (String) does not match expected (Regexp)" do
+      lambda { "string".should match(/rings/) }.should fail
+    end
+
+    it "should provide message, expected and actual on failure" do
+      matcher = match(/rings/)
+      matcher.matches?("string")
+      matcher.failure_message.should == ["expected \"string\" to match /rings/", /rings/, "string"]
+    end
+
+  end
+
+  describe "should_not match(expected)" do
+
+    it "should pass when target (String) matches does not match (Regexp)" do
+      "string".should_not match(/rings/)
+    end
+
+    it "should fail when target (String) matches expected (Regexp)" do
+      lambda {
+        "string".should_not match(/tri/)
+      }.should fail
+    end
+
+    it "should provide message, expected and actual on failure" do
+      matcher = match(/tri/)
+      matcher.matches?("string")
+      matcher.negative_failure_message.should == ["expected \"string\" not to match /tri/", /tri/, "string"]
+    end
+
+  end
+
+end

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

@@ -0,0 +1,78 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+describe Micronaut::Matchers, "provides the following matchers to examples" do
+
+  it "be_true" do
+    be_true.should be_an_instance_of(Micronaut::Matchers::Be)
+  end
+
+  it "be_false" do
+    be_false.should be_an_instance_of(Micronaut::Matchers::Be)
+  end
+
+  it "be_nil" do
+    be_nil.should be_an_instance_of(Micronaut::Matchers::Be)
+  end
+
+  it "be_arbitrary_predicate" do
+    be_arbitrary_predicate.should be_an_instance_of(Micronaut::Matchers::Be)
+  end
+
+  it "change" do
+    change("target", :message).should be_an_instance_of(Micronaut::Matchers::Change)
+  end
+
+  it "have" do
+    have(0).should be_an_instance_of(Micronaut::Matchers::Have)
+  end
+
+  it "have_exactly" do
+    have_exactly(0).should be_an_instance_of(Micronaut::Matchers::Have)
+  end
+
+  it "have_at_least" do
+    have_at_least(0).should be_an_instance_of(Micronaut::Matchers::Have)
+  end
+
+  it "have_at_most" do
+    have_at_most(0).should be_an_instance_of(Micronaut::Matchers::Have)
+  end
+
+  it "include" do
+    include(:value).should be_an_instance_of(Micronaut::Matchers::Include)
+  end
+
+  it "raise_error" do
+    raise_error.should be_an_instance_of(Micronaut::Matchers::RaiseError)
+    raise_error(NoMethodError).should be_an_instance_of(Micronaut::Matchers::RaiseError)
+    raise_error(NoMethodError, "message").should be_an_instance_of(Micronaut::Matchers::RaiseError)
+  end
+
+  it "satisfy" do
+    satisfy{}.should be_an_instance_of(Micronaut::Matchers::Satisfy)
+  end
+
+  it "throw_symbol" do
+    throw_symbol.should be_an_instance_of(Micronaut::Matchers::ThrowSymbol)
+    throw_symbol(:sym).should be_an_instance_of(Micronaut::Matchers::ThrowSymbol)
+  end
+
+  it "respond_to" do
+    respond_to(:sym).should be_an_instance_of(Micronaut::Matchers::RespondTo)
+  end
+  
+  describe "#method_missing" do
+
+    it "should convert be_xyz to Be(:be_xyz)" do
+      Micronaut::Matchers::Be.expects(:new).with(:be_whatever)
+      be_whatever
+    end
+
+    it "should convert have_xyz to Has(:have_xyz)" do
+      self.expects(:has).with(:have_whatever)
+      have_whatever
+    end
+
+  end
+
+end

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

@@ -0,0 +1,193 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+describe "Operator Matchers" do 
+  
+  describe "should ==" do
+  
+    it "should delegate message to target" do
+      subject = "apple"
+      subject.expects(:==).with("apple").returns(true)
+      subject.should == "apple"
+    end
+  
+    it "should return true on success" do
+      subject = "apple"
+      (subject.should == "apple").should be_true
+    end
+  
+    it "should fail when target.==(actual) returns false" do
+      subject = "apple"
+      Micronaut::Expectations.expects(:fail_with).with(%[expected: "orange",\n     got: "apple" (using ==)], "orange", "apple")
+      subject.should == "orange"
+    end
+  
+  end
+
+  describe "should_not ==" do
+  
+    it "should delegate message to target" do
+      subject = "orange"
+      subject.expects(:==).with("apple").returns(false)
+      subject.should_not == "apple"
+    end
+  
+    it "should return true on success" do
+      subject = "apple"
+      (subject.should_not == "orange").should be_true
+    end
+
+    it "should fail when target.==(actual) returns false" do
+      subject = "apple"
+      Micronaut::Expectations.expects(:fail_with).with(%[expected not: == "apple",\n         got:    "apple"], "apple", "apple")
+      subject.should_not == "apple"
+    end
+  
+  end
+
+  describe "should ===" do
+  
+    it "should delegate message to target" do
+      subject = "apple"
+      subject.expects(:===).with("apple").returns(true)
+      subject.should === "apple"
+    end
+  
+    it "should fail when target.===(actual) returns false" do
+      subject = "apple"
+      subject.expects(:===).with("orange").returns(false)
+      Micronaut::Expectations.expects(:fail_with).with(%[expected: "orange",\n     got: "apple" (using ===)], "orange", "apple")
+      subject.should === "orange"
+    end
+  
+  end
+
+  describe "should_not ===" do
+  
+    it "should delegate message to target" do
+      subject = "orange"
+      subject.expects(:===).with("apple").returns(false)
+      subject.should_not === "apple"
+    end
+  
+    it "should fail when target.===(actual) returns false" do
+      subject = "apple"
+      subject.expects(:===).with("apple").returns(true)
+      Micronaut::Expectations.expects(:fail_with).with(%[expected not: === "apple",\n         got:     "apple"], "apple", "apple")
+      subject.should_not === "apple"
+    end
+
+  end
+
+  describe "should =~" do
+  
+    it "should delegate message to target" do
+      subject = "foo"
+      subject.expects(:=~).with(/oo/).returns(true)
+      subject.should =~ /oo/
+    end
+  
+    it "should fail when target.=~(actual) returns false" do
+      subject = "fu"
+      subject.expects(:=~).with(/oo/).returns(false)
+      Micronaut::Expectations.expects(:fail_with).with(%[expected: /oo/,\n     got: "fu" (using =~)], /oo/, "fu")
+      subject.should =~ /oo/
+    end
+
+  end
+
+  describe "should_not =~" do
+  
+    it "should delegate message to target" do
+      subject = "fu"
+      subject.expects(:=~).with(/oo/).returns(false)
+      subject.should_not =~ /oo/
+    end
+  
+    it "should fail when target.=~(actual) returns false" do
+      subject = "foo"
+      subject.expects(:=~).with(/oo/).returns(true)
+      Micronaut::Expectations.expects(:fail_with).with(%[expected not: =~ /oo/,\n         got:    "foo"], /oo/, "foo")
+      subject.should_not =~ /oo/
+    end
+
+  end
+
+  describe "should >" do
+  
+    it "should pass if > passes" do
+      4.should > 3
+    end
+
+    it "should fail if > fails" do
+      Micronaut::Expectations.expects(:fail_with).with(%[expected: > 5,\n     got:   4], 5, 4)
+      4.should > 5
+    end
+
+  end
+
+  describe "should >=" do
+  
+    it "should pass if >= passes" do
+      4.should > 3
+      4.should >= 4
+    end
+
+    it "should fail if > fails" do
+      Micronaut::Expectations.expects(:fail_with).with(%[expected: >= 5,\n     got:    4], 5, 4)
+      4.should >= 5
+    end
+
+  end
+
+  describe "should <" do
+  
+    it "should pass if < passes" do
+      4.should < 5
+    end
+
+    it "should fail if > fails" do
+      Micronaut::Expectations.expects(:fail_with).with(%[expected: < 3,\n     got:   4], 3, 4)
+      4.should < 3
+    end
+
+  end
+
+  describe "should <=" do
+  
+    it "should pass if <= passes" do
+      4.should <= 5
+      4.should <= 4
+    end
+
+    it "should fail if > fails" do
+      Micronaut::Expectations.expects(:fail_with).with(%[expected: <= 3,\n     got:    4], 3, 4)
+      4.should <= 3
+    end
+
+  end
+
+  describe Micronaut::Matchers::PositiveOperatorMatcher do
+
+    it "should work when the target has implemented #send" do
+      o = Object.new
+      def o.send(*args); raise "DOH! Library developers shouldn't use #send!" end
+      lambda {
+        o.should == o
+      }.should_not raise_error
+    end
+
+  end
+
+  describe Micronaut::Matchers::NegativeOperatorMatcher do
+
+    it "should work when the target has implemented #send" do
+      o = Object.new
+      def o.send(*args); raise "DOH! Library developers shouldn't use #send!" end
+      lambda {
+        o.should_not == :foo
+      }.should_not raise_error
+    end
+
+  end
+
+end

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

@@ -0,0 +1,348 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+describe Micronaut::Matchers, "raise_error" do
+
+  describe "should raise_error" do
+  
+    it "should pass if anything is raised" do
+      lambda {raise}.should raise_error
+    end
+  
+    it "should fail if nothing is raised" do
+      lambda {
+        lambda {}.should raise_error
+      }.should fail_with("expected Exception but nothing was raised")
+    end
+  
+  end
+
+  describe "should_not raise_error" do
+  
+    it "should pass if nothing is raised" do
+      lambda {}.should_not raise_error
+    end
+  
+    it "should fail if anything is raised" do
+      lambda {
+        lambda {raise}.should_not raise_error
+      }.should fail_with("expected no Exception, got RuntimeError")
+    end
+  
+  end
+
+  describe "should raise_error(message)" do
+  
+    it "should pass if RuntimeError is raised with the right message" do
+      lambda {raise 'blah'}.should raise_error('blah')
+    end
+  
+    it "should pass if RuntimeError is raised with a matching message" do
+      lambda {raise 'blah'}.should raise_error(/blah/)
+    end
+  
+    it "should pass if any other error is raised with the right message" do
+      lambda {raise NameError.new('blah')}.should raise_error('blah')
+    end
+  
+    it "should fail if RuntimeError error is raised with the wrong message" do
+      lambda do
+        lambda {raise 'blarg'}.should raise_error('blah')
+      end.should fail_with("expected Exception with \"blah\", got #<RuntimeError: blarg>")
+    end
+  
+    it "should fail if any other error is raised with the wrong message" do
+      lambda do
+        lambda {raise NameError.new('blarg')}.should raise_error('blah')
+      end.should fail_with("expected Exception with \"blah\", got #<NameError: blarg>")
+    end
+  
+  end
+
+  describe "should_not raise_error(message)" do
+  
+    it "should pass if RuntimeError error is raised with the different message" do
+      lambda {raise 'blarg'}.should_not raise_error('blah')
+    end
+  
+    it "should pass if any other error is raised with the wrong message" do
+      lambda {raise NameError.new('blarg')}.should_not raise_error('blah')
+    end
+  
+    it "should fail if RuntimeError is raised with message" do
+      lambda do
+        lambda {raise 'blah'}.should_not raise_error('blah')
+      end.should fail_with(%Q|expected no Exception with "blah", got #<RuntimeError: blah>|)
+    end
+  
+    it "should fail if any other error is raised with message" do
+      lambda do
+        lambda {raise NameError.new('blah')}.should_not raise_error('blah')
+      end.should fail_with(%Q|expected no Exception with "blah", got #<NameError: blah>|)
+    end
+  
+  end
+
+  describe "should raise_error(NamedError)" do
+  
+    it "should pass if named error is raised" do
+      lambda { non_existent_method }.should raise_error(NameError)
+    end
+  
+    it "should fail if nothing is raised" do
+      lambda {
+        lambda { }.should raise_error(NameError)
+      }.should fail_with("expected NameError but nothing was raised")
+    end
+  
+    it "should fail if another error is raised (NameError)" do
+      lambda {
+        lambda { raise }.should raise_error(NameError)
+      }.should fail_with("expected NameError, got RuntimeError")
+    end
+  
+    it "should fail if another error is raised (NameError)" do
+      lambda {
+        lambda { load "non/existent/file" }.should raise_error(NameError)
+      }.should fail_with(/expected NameError, got #<LoadError/)
+    end
+  
+  end
+
+  describe "should_not raise_error(NamedError)" do
+  
+    it "should pass if nothing is raised" do
+      lambda { }.should_not raise_error(NameError)
+    end
+  
+    it "should pass if another error is raised" do
+      lambda { raise }.should_not raise_error(NameError)
+    end
+  
+    it "should fail if named error is raised" do
+      lambda {
+        lambda { non_existent_method }.should_not raise_error(NameError)
+      }.should fail_with(/expected no NameError, got #<NameError: undefined/)
+    end  
+  
+  end
+
+  describe "should raise_error(NamedError, error_message) with String" do
+  
+    it "should pass if named error is raised with same message" do
+      lambda { raise "example message" }.should raise_error(RuntimeError, "example message")
+    end
+  
+    it "should fail if nothing is raised" do
+      lambda {
+        lambda {}.should raise_error(RuntimeError, "example message")
+      }.should fail_with("expected RuntimeError with \"example message\" but nothing was raised")
+    end
+  
+    it "should fail if incorrect error is raised" do
+      lambda {
+        lambda { raise }.should raise_error(NameError, "example message")
+      }.should fail_with("expected NameError with \"example message\", got RuntimeError")
+    end
+  
+    it "should fail if correct error is raised with incorrect message" do
+      lambda {
+        lambda { raise RuntimeError.new("not the example message") }.should raise_error(RuntimeError, "example message")
+      }.should fail_with(/expected RuntimeError with \"example message\", got #<RuntimeError: not the example message/)
+    end
+  
+  end
+
+  describe "should raise_error(NamedError, error_message) { |err| ... }" do
+  
+    it "should yield exception if named error is raised with same message" do
+      ran = false
+
+      lambda {
+        raise "example message"
+      }.should raise_error(RuntimeError, "example message") { |err|
+        ran = true
+        err.class.should == RuntimeError
+        err.message.should == "example message"
+      }
+
+      ran.should == true
+    end
+
+    it "yielded block should be able to fail on it's own right" do
+      ran, passed = false, false
+
+      lambda {
+        lambda { raise "example message" }.should raise_error(RuntimeError, "example message") { |err|
+          ran = true
+          5.should == 4
+          passed = true
+        }
+      }.should fail_with(/expected: 4/m)
+
+      ran.should == true
+      passed.should == false
+    end
+
+    it "should NOT yield exception if no error was thrown" do
+      ran = false
+
+      lambda {
+        lambda {}.should raise_error(RuntimeError, "example message") { |err|
+          ran = true
+        }
+      }.should fail_with("expected RuntimeError with \"example message\" but nothing was raised")
+
+      ran.should == false
+    end
+
+    it "should not yield exception if error class is not matched" do
+      ran = false
+
+      lambda {
+        lambda {
+          raise "example message"
+        }.should raise_error(SyntaxError, "example message") { |err|
+          ran = true
+        }
+      }.should fail_with("expected SyntaxError with \"example message\", got #<RuntimeError: example message>")
+
+      ran.should == false
+    end
+
+    it "should NOT yield exception if error message is not matched" do
+      ran = false
+
+      lambda {
+        lambda {
+          raise "example message"
+        }.should raise_error(RuntimeError, "different message") { |err|
+          ran = true
+        }
+      }.should fail_with("expected RuntimeError with \"different message\", got #<RuntimeError: example message>")
+
+      ran.should == false
+    end
+  
+  end
+
+  describe "should_not raise_error(NamedError, error_message) { |err| ... }" do
+  
+    it "should pass if nothing is raised" do
+      ran = false
+
+      lambda {}.should_not raise_error(RuntimeError, "example message") { |err|
+        ran = true
+      }
+
+      ran.should == false
+    end
+
+    it "should pass if a different error is raised" do
+      ran = false
+
+      lambda { raise }.should_not raise_error(NameError, "example message") { |err|
+        ran = true
+      }
+
+      ran.should == false
+    end
+
+    it "should pass if same error is raised with different message" do
+      ran = false
+
+      lambda {
+        raise RuntimeError.new("not the example message")
+      }.should_not raise_error(RuntimeError, "example message") { |err|
+        ran = true
+      }
+
+      ran.should == false
+    end
+
+    it "should fail if named error is raised with same message" do
+      ran = false
+
+      lambda {
+        lambda {
+          raise "example message"
+        }.should_not raise_error(RuntimeError, "example message") { |err|
+          ran = true
+        }
+      }.should fail_with("expected no RuntimeError with \"example message\", got #<RuntimeError: example message>")
+
+      ran.should == false
+    end
+  
+  end
+
+  describe "should_not raise_error(NamedError, error_message) with String" do
+  
+    it "should pass if nothing is raised" do
+      lambda {}.should_not raise_error(RuntimeError, "example message")
+    end
+  
+    it "should pass if a different error is raised" do
+      lambda { raise }.should_not raise_error(NameError, "example message")
+    end
+  
+    it "should pass if same error is raised with different message" do
+      lambda { raise RuntimeError.new("not the example message") }.should_not raise_error(RuntimeError, "example message")
+    end
+  
+    it "should fail if named error is raised with same message" do
+      lambda {
+        lambda { raise "example message" }.should_not raise_error(RuntimeError, "example message")
+      }.should fail_with("expected no RuntimeError with \"example message\", got #<RuntimeError: example message>")
+    end
+  
+  end
+
+  describe "should raise_error(NamedError, error_message) with Regexp" do
+  
+    it "should pass if named error is raised with matching message" do
+      lambda { raise "example message" }.should raise_error(RuntimeError, /ample mess/)
+    end
+  
+    it "should fail if nothing is raised" do
+      lambda {
+        lambda {}.should raise_error(RuntimeError, /ample mess/)
+      }.should fail_with("expected RuntimeError with message matching /ample mess/ but nothing was raised")
+    end
+  
+    it "should fail if incorrect error is raised" do
+      lambda {
+        lambda { raise }.should raise_error(NameError, /ample mess/)
+      }.should fail_with("expected NameError with message matching /ample mess/, got RuntimeError")
+    end
+  
+    it "should fail if correct error is raised with incorrect message" do
+      lambda {
+        lambda { raise RuntimeError.new("not the example message") }.should raise_error(RuntimeError, /less than ample mess/)
+      }.should fail_with("expected RuntimeError with message matching /less than ample mess/, got #<RuntimeError: not the example message>")
+    end
+  
+  end
+
+  describe "should_not raise_error(NamedError, error_message) with Regexp" do
+  
+    it "should pass if nothing is raised" do
+      lambda {}.should_not raise_error(RuntimeError, /ample mess/)
+    end
+  
+    it "should pass if a different error is raised" do
+      lambda { raise }.should_not raise_error(NameError, /ample mess/)
+    end
+  
+    it "should pass if same error is raised with non-matching message" do
+      lambda { raise RuntimeError.new("non matching message") }.should_not raise_error(RuntimeError, /ample mess/)
+    end
+  
+    it "should fail if named error is raised with matching message" do
+      lambda {
+        lambda { raise "example message" }.should_not raise_error(RuntimeError, /ample mess/)
+      }.should fail_with("expected no RuntimeError with message matching /ample mess/, got #<RuntimeError: example message>")
+    end
+  
+  end
+  
+end