spicycode-micronaut 0.0.2 → 0.0.3

data/Rakefile

@@ -4,7 +4,7 @@ require 'rubygems/specification'
 require 'date'
 
 GEM = "micronaut"
-GEM_VERSION = "0.0.2"
+GEM_VERSION = "0.0.3"
 AUTHOR = "Chad Humphries"
 EMAIL = "chad@spicycode.com"
 HOMEPAGE = "http://spicycode.com"
@@ -30,14 +30,6 @@ spec = Gem::Specification.new do |s|
   s.files = %w(LICENSE README Rakefile) + Dir.glob("{lib,examples}/**/*")
 end
 
-desc "Run all examples"
-task :default do
-  examples = Dir["examples/**/*_example.rb"].map { |g| Dir.glob(g) }.flatten
-  examples.map! {|f| %Q(require "#{f}")}
-  command = "-e '#{examples.join("; ")}'"
-  ruby command
-end
-
 Rake::GemPackageTask.new(spec) do |pkg|
   pkg.gem_spec = spec
 end
@@ -52,4 +44,25 @@ task :make_spec do
   File.open("#{GEM}.gemspec", "w") do |file|
     file.puts spec.to_ruby
   end
-end
+end
+
+namespace :micronaut do
+  
+  desc 'Run all examples'
+  task :examples do
+    examples = Dir["examples/**/*_example.rb"].map { |g| Dir.glob(g) }.flatten
+    examples.map! {|f| %Q(require "#{f}")}
+    command = "-e '#{examples.join("; ")}'"
+    ruby command
+  end
+  
+  desc "Run all examples using rcov"
+  task :coverage do
+    examples = Dir["examples/**/*_example.rb"].map { |g| Dir.glob(g) }.flatten
+    system "rcov --exclude \"examples/*,gems/*,db/*,/Library/Ruby/*,config/*\" --text-report --sort coverage --no-validator-links #{examples.join(' ')}"
+  end
+  
+end
+
+task :default => 'micronaut:coverage'
+

data/examples/example_helper.rb

@@ -2,16 +2,16 @@ lib_path = File.expand_path(File.dirname(__FILE__) + "/../lib")
 $LOAD_PATH.unshift lib_path unless $LOAD_PATH.include?(lib_path)
 
 require 'micronaut'
-
+require File.expand_path(File.dirname(__FILE__) + "/resources/example_classes")
 
 module Micronaut  
   module Matchers
     def fail
-      raise_error(::Micronaut::Exceptions::ExpectationNotMetError)
+      raise_error(::Micronaut::Expectations::ExpectationNotMetError)
     end
 
     def fail_with(message)
-      raise_error(::Micronaut::Exceptions::ExpectationNotMetError, message)
+      raise_error(::Micronaut::Expectations::ExpectationNotMetError, message)
     end
   end
 end

data/examples/lib/micronaut/behaviour_group_example.rb

@@ -0,0 +1,175 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../example_helper")
+
+describe Micronaut::BehaviourGroup do
+
+  class Foo
+
+  end  
+
+  def empty_behaviour_group
+    Micronaut::BehaviourGroup.describe(Foo, 'Empty Behaviour Group') { }
+  end
+
+  describe "describing behaviour with #describe" do
+
+    it "should raise an ArgumentError if no name is given" do
+      lambda { Micronaut::BehaviourGroup.describe() {} }.should raise_error(ArgumentError)
+    end
+    
+    it "should raise an ArgumentError if no block is given" do
+      lambda { Micronaut::BehaviourGroup.describe('foo') }.should raise_error(ArgumentError)
+    end
+    
+    describe '#name' do
+      
+      it "should expose the first parameter as name" do
+        Micronaut::BehaviourGroup.describe("my favorite pony") { }.name.should == 'my favorite pony'
+      end
+
+      it "should call to_s on the first parameter in case it is a constant" do
+        Micronaut::BehaviourGroup.describe(Foo) { }.name.should == 'Foo'
+      end
+    
+    end
+
+    describe '#described_type' do
+      
+      it "should be the first parameter when it is a constant" do
+        Micronaut::BehaviourGroup.describe(Foo) { }.described_type.should == Foo
+      end
+      
+      it "should be Object when the first parameter is a string" do
+        Micronaut::BehaviourGroup.describe("i'm a computer") { }.described_type.should == Object
+      end
+      
+    end
+    
+    describe '#description' do
+      
+      it "should expose the second parameter as description" do
+        Micronaut::BehaviourGroup.describe(Foo, "my desc") { }.description.should == 'my desc'
+      end
+
+      it "should allow the second parameter to be nil" do
+        Micronaut::BehaviourGroup.describe(Foo, nil) { }.description.should be_nil
+      end
+      
+    end
+
+    describe '#options' do
+    
+      it "should expose the third parameter as options" do
+        Micronaut::BehaviourGroup.describe(Foo, nil, 'foo' => 'bar') { }.options.should == { "foo" => 'bar' }
+      end
+    
+      it "should be an empty hash if no options are supplied" do
+        Micronaut::BehaviourGroup.describe(Foo, nil) { }.options.should == {}
+      end
+    
+    end
+    
+    describe "adding before and after hooks" do
+      
+      it "should expose the before each blocks at before_eachs" do
+        group = empty_behaviour_group
+        group.before(:each) { 'foo' }
+        group.should have(1).before_eachs
+      end
+
+      it "should maintain the before each block order" do
+        group = empty_behaviour_group 
+        group.before(:each) { 15 }
+        group.before(:each) { 'A' }
+        group.before(:each) { 33.5 }
+
+        group.before_eachs[0].call.should == 15
+        group.before_eachs[1].call.should == 'A'
+        group.before_eachs[2].call.should == 33.5
+      end
+
+      it "should expose the before all blocks at before_alls" do
+        group = empty_behaviour_group
+        group.before(:all) { 'foo' }
+        group.should have(1).before_alls
+      end
+
+      it "should maintain the before all block order" do
+        group = empty_behaviour_group 
+        group.before(:all) { 15 }
+        group.before(:all) { 'A' }
+        group.before(:all) { 33.5 }
+
+        group.before_alls[0].call.should == 15
+        group.before_alls[1].call.should == 'A'
+        group.before_alls[2].call.should == 33.5
+      end
+
+      it "should expose the after each blocks at after_eachs" do
+        group = empty_behaviour_group
+        group.after(:each) { 'foo' }
+        group.should have(1).after_eachs
+      end
+
+      it "should maintain the after each block order" do
+        group = empty_behaviour_group 
+        group.after(:each) { 15 }
+        group.after(:each) { 'A' }
+        group.after(:each) { 33.5 }
+
+        group.after_eachs[0].call.should == 15
+        group.after_eachs[1].call.should == 'A'
+        group.after_eachs[2].call.should == 33.5
+      end
+
+      it "should expose the after all blocks at after_alls" do
+        group = empty_behaviour_group
+        group.after(:all) { 'foo' }
+        group.should have(1).after_alls
+      end
+
+      it "should maintain the after each block order" do
+        group = empty_behaviour_group 
+        group.after(:all) { 15 }
+        group.after(:all) { 'A' }
+        group.after(:all) { 33.5 }
+
+        group.after_alls[0].call.should == 15
+        group.after_alls[1].call.should == 'A'
+        group.after_alls[2].call.should == 33.5
+      end
+
+    end
+
+    describe "adding examples" do
+
+      it "should allow adding an example using 'it'" do
+        group = empty_behaviour_group
+        group.it("should do something") { }
+        group.examples.size.should == 1
+      end
+
+      it "should expose all examples at examples" do
+        group = empty_behaviour_group
+        group.it("should do something 1") { }
+        group.it("should do something 2") { }
+        group.it("should do something 3") { }
+        group.examples.size.should == 3
+      end
+
+      it "should maintain the example order" do
+        group = empty_behaviour_group
+        group.it("should 1") { }
+        group.it("should 2") { }
+        group.it("should 3") { }
+        group.examples[0].first.should == 'should 1'
+        group.examples[1].first.should == 'should 2'
+        group.examples[2].first.should == 'should 3'
+      end
+
+    end
+    
+    
+  end
+  
+  
+end

data/examples/lib/micronaut/expectations/differs/default_example.rb

@@ -21,7 +21,6 @@ module Micronaut
 end
 
 describe "Diff" do
-
   before do
     @differ = Micronaut::Expectations::Differs::Default.new(:unified)
   end
@@ -97,7 +96,7 @@ end
 
 
 describe "Diff in context format" do
-  before(:each) do
+  before do
     @differ = Micronaut::Expectations::Differs::Default.new(:context)
   end
 

data/examples/lib/micronaut/expectations/extensions/object_example.rb

@@ -2,7 +2,7 @@ require File.expand_path(File.dirname(__FILE__) + "/../../../../example_helper")
 
 describe Object, "#should" do
   
-  before(:each) do
+  before do
     @target = "target"
     @matcher = mock("matcher")
     @matcher.stubs(:matches?).returns(true)
@@ -17,27 +17,34 @@ describe Object, "#should" do
   it "should ask for a failure_message when matches? returns false" do
     @matcher.expects(:matches?).with(@target).returns(false)
     @matcher.expects(:failure_message).returns("the failure message")
-    
-    lambda { @target.should @matcher }.should fail_with("the failure message")
+    lambda {
+      @target.should @matcher
+    }.should fail_with("the failure message")
   end
   
   it "should raise error if it receives false directly" do
-    lambda { @target.should false }.should raise_error(Micronaut::Expectations::InvalidMatcherError)
+    lambda {
+      @target.should false
+    }.should raise_error(Micronaut::Expectations::InvalidMatcherError)
   end
   
   it "should raise error if it receives false (evaluated)" do
-    lambda { @target.should eql?("foo") }.should raise_error(Micronaut::Expectations::InvalidMatcherError)
+    lambda {
+      @target.should eql?("foo")
+    }.should raise_error(Micronaut::Expectations::InvalidMatcherError)
   end
   
   it "should raise error if it receives true" do
-    lambda { @target.should true }.should raise_error(Micronaut::Expectations::InvalidMatcherError)
+    lambda {
+      @target.should true
+    }.should raise_error(Micronaut::Expectations::InvalidMatcherError)
   end
   
 end
 
 describe Object, "#should_not" do
   
-  before(:each) do
+  before do
     @target = "target"
     @matcher = mock("matcher")
   end
@@ -74,5 +81,5 @@ describe Object, "#should_not" do
       @target.should_not true
     }.should raise_error(Micronaut::Expectations::InvalidMatcherError)
   end
-  
+
 end

data/examples/lib/micronaut/expectations/fail_with_example.rb

@@ -1,7 +1,7 @@
 require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
 
 describe Micronaut::Expectations, "#fail_with with no diff" do
-  before(:each) do
+  before do
     @old_differ = Micronaut::Expectations.differ
     Micronaut::Expectations.differ = nil
   end
@@ -24,7 +24,7 @@ describe Micronaut::Expectations, "#fail_with with no diff" do
 end
 
 describe Micronaut::Expectations, "#fail_with with diff" do
-  before(:each) do
+  before do
     @old_differ = Micronaut::Expectations.differ
     @differ = mock("differ")
     Micronaut::Expectations.differ = @differ

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

@@ -0,0 +1,42 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+module Micronaut
+  module Matchers
+    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
+end

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

@@ -0,0 +1,257 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../../example_helper")
+
+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 {
+      actual.should be_happy
+    }.should fail_with("expected happy? to return true, got false")
+  end
+  
+  it "should fail when actual does not respond to :predicate?" do
+    lambda {
+      Object.new.should be_happy
+    }.should raise_error(NameError, /happy\?/)
+  end
+  
+  it "should fail on error other than NameError" do
+    actual = stub("actual")
+    actual.expects(:foo?).raises("aaaah")
+    lambda {
+      actual.should be_foo
+    }.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 {
+      actual.should be_foo
+    }.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 {
+      actual.should_not be_happy
+    }.should fail_with("expected happy? to return false, got true")
+  end
+
+  it "should fail when actual does not respond to :sym?" do
+    lambda {
+      Object.new.should_not be_happy
+    }.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 {
+      actual.should be_older_than(3)
+    }.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 {
+      Object.new.should be_older_than(3)
+    }.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 {
+      actual.should_not be_older_than(3)
+    }.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 {
+      Object.new.should_not be_older_than(3)
+    }.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 {
+      false.should be_true
+    }.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 {
+      true.should be_false
+    }.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 {
+      :not_nil.should be_nil
+    }.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 {
+      nil.should_not be_nil
+    }.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 {
+      5.should_not be < 6
+    }.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