mspec 1.0.0

data/spec/runner/actions/tally_spec.rb

@@ -0,0 +1,107 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require 'mspec/expectations/expectations'
+require 'mspec/runner/actions/tally'
+require 'mspec/runner/mspec'
+require 'mspec/runner/state'
+
+describe Tally do
+  before :each do
+    @tally = Tally.new
+  end
+
+  it "responds to #files! by incrementing the count returned by #files" do
+    @tally.files! 3
+    @tally.files.should == 3
+    @tally.files!
+    @tally.files.should == 4
+  end
+
+  it "responds to #examples! by incrementing the count returned by #examples" do
+    @tally.examples! 2
+    @tally.examples.should == 2
+    @tally.examples! 2
+    @tally.examples.should == 4
+  end
+
+  it "responds to #expectations! by incrementing the count returned by #expectations" do
+    @tally.expectations!
+    @tally.expectations.should == 1
+    @tally.expectations! 3
+    @tally.expectations.should == 4
+  end
+
+  it "responds to #failures! by incrementing the count returned by #failures" do
+    @tally.failures! 1
+    @tally.failures.should == 1
+    @tally.failures!
+    @tally.failures.should == 2
+  end
+
+  it "responds to #errors! by incrementing the count returned by #errors" do
+    @tally.errors!
+    @tally.errors.should == 1
+    @tally.errors! 2
+    @tally.errors.should == 3
+  end
+
+  it "responds to #format by returning a formatted string of counts" do
+    @tally.files!
+    @tally.examples! 2
+    @tally.expectations! 4
+    @tally.errors!
+    @tally.format.should == "1 file, 2 examples, 4 expectations, 0 failures, 1 error"
+  end
+end
+
+describe TallyAction do
+  before :each do
+    @tally = TallyAction.new
+    @state = SpecState.new("describe", "it")
+    @state.exceptions << ["msg", Exception.new("it broke")]
+    @state.exceptions << ["msg", ExpectationNotMetError.new("disappointment")]
+  end
+
+  it "responds to #counter by returning the Tally object" do
+    @tally.counter.should be_kind_of(Tally)
+  end
+
+  it "responds to #load by incrementing the count returned by Tally#files" do
+    @tally.load
+    @tally.counter.files.should == 1
+  end
+
+  it "responds to #expectation by incrementing the count returned by Tally#expectations" do
+    @tally.expectation @state
+    @tally.counter.expectations.should == 1
+  end
+
+  it "responds to #after by incrementing counts returned by Tally#examples, #failures, #errors" do
+    @tally.after @state
+    @tally.counter.examples.should == 1
+    @tally.counter.expectations.should == 0
+    @tally.counter.failures.should == 1
+    @tally.counter.errors.should == 1
+  end
+
+  it "responds to #format by returning a readable string of counts" do
+    @tally.load
+    @tally.after @state
+    @tally.expectation @state
+    @tally.expectation @state
+    @tally.format.should == "1 file, 1 example, 2 expectations, 1 failure, 1 error"
+  end
+
+  it "responds to #register by registering itself with MSpec for appropriate actions" do
+    MSpec.should_receive(:register).with(:load, @tally)
+    MSpec.should_receive(:register).with(:after, @tally)
+    MSpec.should_receive(:register).with(:expectation, @tally)
+    @tally.register
+  end
+
+  it "responds to #unregister by unregistering itself with MSpec for appropriate actions" do
+    MSpec.should_receive(:unregister).with(:load, @tally)
+    MSpec.should_receive(:unregister).with(:after, @tally)
+    MSpec.should_receive(:unregister).with(:expectation, @tally)
+    @tally.unregister
+  end
+end

data/spec/runner/actions/timer_spec.rb

@@ -0,0 +1,42 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require 'mspec/runner/actions/timer'
+require 'mspec/runner/mspec'
+require 'time'
+
+describe TimerAction do
+  before :each do
+    @timer = TimerAction.new
+  end
+
+  it "responds to #start by recording the current time" do
+    Time.should_receive(:now)
+    @timer.start
+  end
+
+  it "responds to #finish by recording the current time" do
+    Time.should_receive(:now)
+    @timer.finish
+  end
+
+  it "responds to #elapsed by returning the difference between stop and start" do
+    Time.stub!(:now).and_return(Time.parse('10/18/2007 5:43:18'))
+    @timer.start
+    Time.stub!(:now).and_return(Time.parse('10/18/2007 5:43:51'))
+    @timer.finish
+    @timer.elapsed.should == 33
+  end
+
+  it "responds to #format by returning a readable string of elapsed time" do
+    Time.stub!(:now).and_return(Time.parse('10/18/2007 5:43:18'))
+    @timer.start
+    Time.stub!(:now).and_return(Time.parse('10/18/2007 5:43:51'))
+    @timer.finish
+    @timer.format.should == "Finished in 33.000000 seconds"
+  end
+
+  it "responds to #register by registering itself with MSpec for appropriate actions" do
+    MSpec.should_receive(:register).with(:start, @timer)
+    MSpec.should_receive(:register).with(:finish, @timer)
+    @timer.register
+  end
+end

data/spec/runner/filters/a.yaml

@@ -0,0 +1,4 @@
+---
+A#: 
+- a
+- aa

data/spec/runner/filters/b.yaml

@@ -0,0 +1,11 @@
+---
+B.: 
+- b
+- bb
+B::C#:
+- b!
+- b=
+- b?
+- "-"
+- "[]"
+- "[]="

data/spec/runner/filters/match_spec.rb

@@ -0,0 +1,44 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require 'mspec/runner/mspec'
+require 'mspec/runner/filters/match'
+
+describe MatchFilter, "#to_regexp" do
+  before :each do
+    @filter = MatchFilter.new nil
+  end
+
+  it "converts its arguments to Regexp instances" do
+    @filter.to_regexp('a', 'b', 'c').should == [/a/, /b/, /c/]
+  end
+end
+
+describe MatchFilter, "#===" do
+  before :each do
+    @filter = MatchFilter.new nil, 'a', 'b', 'c'
+  end
+
+  it "returns true if the argument matches any of the #initialize strings" do
+    @filter.===('aaa').should == true
+    @filter.===('bccb').should == true
+  end
+
+  it "returns false if the argument matches none of the #initialize strings" do
+    @filter.===('d').should == false
+  end
+end
+
+describe MatchFilter, "#register" do
+  it "registers itself with MSpec for the designated action list" do
+    filter = MatchFilter.new :include
+    MSpec.should_receive(:register).with(:include, filter)
+    filter.register
+  end
+end
+
+describe MatchFilter, "#unregister" do
+  it "unregisters itself with MSpec for the designated action list" do
+    filter = MatchFilter.new :exclude
+    MSpec.should_receive(:unregister).with(:exclude, filter)
+    filter.unregister
+  end
+end

data/spec/runner/filters/profile_spec.rb

@@ -0,0 +1,117 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require 'mspec/runner/mspec'
+require 'mspec/runner/filters/profile'
+
+describe ProfileFilter, "#find" do
+  before :each do
+    @filter = ProfileFilter.new nil
+    File.stub!(:exist?).and_return(false)
+    @file = "rails.yaml"
+  end
+
+  it "attempts to locate the file through the expanded path name" do
+    File.should_receive(:expand_path).with(@file).and_return(@file)
+    File.should_receive(:exist?).with(@file).and_return(true)
+    @filter.find(@file).should == @file
+  end
+
+  it "attemps to locate the file in 'spec/profiles'" do
+    path = File.join "spec/profiles", @file
+    File.should_receive(:exist?).with(path).and_return(true)
+    @filter.find(@file).should == path
+  end
+
+  it "attemps to locate the file in 'spec'" do
+    path = File.join "spec", @file
+    File.should_receive(:exist?).with(path).and_return(true)
+    @filter.find(@file).should == path
+  end
+
+  it "attemps to locate the file in 'profiles'" do
+    path = File.join "profiles", @file
+    File.should_receive(:exist?).with(path).and_return(true)
+    @filter.find(@file).should == path
+  end
+
+  it "attemps to locate the file in '.'" do
+    path = File.join ".", @file
+    File.should_receive(:exist?).with(path).and_return(true)
+    @filter.find(@file).should == path
+  end
+end
+
+describe ProfileFilter, "#parse" do
+  before :each do
+    @filter = ProfileFilter.new nil
+    @file = File.open(File.dirname(__FILE__) + "/b.yaml", "r")
+  end
+
+  after :each do
+    @file.close
+  end
+
+  it "creates a Hash of the contents of the YAML file" do
+    @filter.parse(@file).should == {
+      "B." => ["b", "bb"],
+      "B::C#" => ["b!", "b=", "b?", "-", "[]", "[]="]
+    }
+  end
+end
+
+describe ProfileFilter, "#load" do
+  before :each do
+    @filter = ProfileFilter.new nil
+    @files = [
+      File.dirname(__FILE__) + "/a.yaml",
+      File.dirname(__FILE__) + "/b.yaml"
+      ]
+  end
+
+  it "generates a composite hash from multiple YAML files" do
+    @filter.load(*@files).should == {
+      "A#"    => ["a", "aa"],
+      "B."    => ["b", "bb"],
+      "B::C#" => ["b!", "b=", "b?", "-", "[]", "[]="]
+    }
+  end
+end
+
+describe ProfileFilter, "#===" do
+  before :each do
+    @filter = ProfileFilter.new nil
+    @filter.stub!(:load).and_return({ "A#" => ["[]=", "a", "a!", "a?", "aa="]})
+    @filter.send :initialize, nil
+  end
+
+  it "returns true if the spec description is for a method in the profile" do
+    @filter.===("The A#[]= method").should == true
+    @filter.===("A#a returns").should == true
+    @filter.===("A#a! replaces").should == true
+    @filter.===("A#a? returns").should == true
+    @filter.===("A#aa= raises").should == true
+  end
+
+  it "returns false if the spec description is for a method not in the profile" do
+    @filter.===("The A#[] method").should == false
+    @filter.===("B#a returns").should == false
+    @filter.===("A.a! replaces").should == false
+    @filter.===("AA#a? returns").should == false
+    @filter.===("A#aa raises").should == false
+  end
+end
+
+describe ProfileFilter, "#register" do
+  it "registers itself with MSpec for the designated action list" do
+    filter = ProfileFilter.new :include
+    MSpec.should_receive(:register).with(:include, filter)
+    filter.register
+  end
+end
+
+describe ProfileFilter, "#unregister" do
+  it "unregisters itself with MSpec for the designated action list" do
+    filter = ProfileFilter.new :exclude
+    MSpec.should_receive(:unregister).with(:exclude, filter)
+    filter.unregister
+  end
+end

data/spec/runner/filters/regexp_spec.rb

@@ -0,0 +1,13 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require 'mspec/runner/mspec'
+require 'mspec/runner/filters/regexp'
+
+describe RegexpFilter, "#to_regexp" do
+  before :each do
+    @filter = RegexpFilter.new nil
+  end
+
+  it "converts its arguments to Regexp instances" do
+    @filter.to_regexp('a(b|c)', 'b[^ab]', 'cc?').should == [/a(b|c)/, /b[^ab]/, /cc?/]
+  end
+end

data/spec/runner/filters/tag_spec.rb

@@ -0,0 +1,77 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require 'mspec/runner/mspec'
+require 'mspec/runner/filters/match'
+require 'mspec/runner/filters/tag'
+
+describe TagFilter, "#load" do
+  before :each do
+    @match = mock("match filter", :null_object => true)
+    @filter = TagFilter.new :include, "tag", "key"
+    @tag = SpecTag.new "tag(comment):description"
+    MSpec.stub!(:read_tags).and_return([@tag])
+    MSpec.stub!(:register)
+  end
+
+  it "loads tags from the tag file" do
+    MSpec.should_receive(:read_tags).with("tag", "key").and_return([])
+    @filter.load
+  end
+
+  it "creates a MatchFilter from the descriptions matching the tags" do
+    MatchFilter.should_receive(:new).with(:include, "description").and_return(@match)
+    @filter.load
+  end
+
+  it "creates an empty MatchFilter if no tags were found" do
+    MSpec.should_receive(:read_tags).and_return([])
+    MatchFilter.should_receive(:new).with(:include).and_return(@match)
+    @filter.load
+  end
+
+  it "registers the MatchFilter if there were tags found in the tag file" do
+    @match.should_receive(:register)
+    MatchFilter.should_receive(:new).with(:include, "description").and_return(@match)
+    @filter.load
+  end
+
+  it "registers the empty MatchFilter if no tags were found" do
+    @match.should_receive(:register)
+    MSpec.should_receive(:read_tags).and_return([])
+    MatchFilter.should_receive(:new).with(:include).and_return(@match)
+    @filter.load
+  end
+end
+
+describe TagFilter, "#unload" do
+  before :each do
+    @filter = TagFilter.new :include, "tag", "key"
+    @tag = SpecTag.new "tag(comment):description"
+    MSpec.stub!(:read_tags).and_return([@tag])
+  end
+
+  it "unregisters the MatchFilter if one was registered" do
+    match = mock("match filter", :null_object => true)
+    match.should_receive(:unregister)
+    MatchFilter.stub!(:new).with(:include, "description").and_return(match)
+    @filter.load
+    @filter.unload
+  end
+end
+
+describe TagFilter, "#register" do
+  it "registers itself with MSpec for the :load, :unload actions" do
+    filter = TagFilter.new(nil)
+    MSpec.should_receive(:register).with(:load, filter)
+    MSpec.should_receive(:register).with(:unload, filter)
+    filter.register
+  end
+end
+
+describe TagFilter, "#unregister" do
+  it "unregisters itself with MSpec for the :load, :unload actions" do
+    filter = TagFilter.new(nil)
+    MSpec.should_receive(:unregister).with(:load, filter)
+    MSpec.should_receive(:unregister).with(:unload, filter)
+    filter.unregister
+  end
+end

data/spec/runner/formatters/dotted_spec.rb

@@ -0,0 +1,184 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require 'mspec/runner/formatters/dotted'
+require 'mspec/runner/mspec'
+require 'mspec/runner/state'
+
+describe DottedFormatter, "#initialize" do
+  it "permits zero arguments" do
+    DottedFormatter.new
+  end
+
+  it "accepts one argument" do
+    DottedFormatter.new nil
+  end
+end
+
+describe DottedFormatter, "#register" do
+  before :each do
+    @formatter = DottedFormatter.new
+  end
+
+  it "registers self with MSpec for appropriate actions" do
+    MSpec.stub!(:register)
+    MSpec.should_receive(:register).with(:after, @formatter)
+    MSpec.should_receive(:register).with(:finish, @formatter)
+    @formatter.register
+  end
+
+  it "creates TimerAction and TallyAction" do
+    timer = mock("timer")
+    tally = mock("tally")
+    timer.should_receive(:register)
+    tally.should_receive(:register)
+    tally.should_receive(:counter)
+    TimerAction.should_receive(:new).and_return(timer)
+    TallyAction.should_receive(:new).and_return(tally)
+    @formatter.register
+  end
+end
+
+describe DottedFormatter, "#print" do
+  after :each do
+    $stdout = STDOUT
+  end
+
+  it "writes to $stdout by default" do
+    $stdout = IOStub.new
+    formatter = DottedFormatter.new
+    formatter.print "begonias"
+    $stdout.should == "begonias"
+  end
+
+  it "writes to the file specified when the formatter was created" do
+    out = IOStub.new
+    File.should_receive(:open).with("some/file", "w").and_return(out)
+    formatter = DottedFormatter.new "some/file"
+    formatter.print "begonias"
+    out.should == "begonias"
+  end
+end
+
+describe DottedFormatter, "#message" do
+  before :each do
+    @formatter = DottedFormatter.new
+  end
+
+  it "returns <No message> if the exception message is empty" do
+    exc = Exception.new ""
+    @formatter.message(exc).should == "<No message>"
+  end
+
+  it "returns the message without exception class when the exception is ExpectationNotMetError" do
+    exc = Exception.new "message"
+    @formatter.message(exc).should == "Exception: message"
+  end
+
+  it "returns the message with exception class when the exception is not ExpectationNotMetError" do
+    exc = ExpectationNotMetError.new "message"
+    @formatter.message(exc).should == "message"
+  end
+end
+
+describe DottedFormatter, "#after" do
+  before :each do
+    $stdout = @out = IOStub.new
+    @formatter = DottedFormatter.new
+    @state = SpecState.new("describe", "it")
+  end
+
+  after :each do
+    $stdout = STDOUT
+  end
+
+  it "prints a '.' if there was no exception raised" do
+    @formatter.after(@state)
+    @out.should == "."
+  end
+
+  it "prints an 'F' if there was an expectation failure" do
+    @state.exceptions << ["msg", ExpectationNotMetError.new("failed")]
+    @formatter.after(@state)
+    @out.should == "F"
+  end
+
+  it "prints an 'E' if there was an exception other than expectation failure" do
+    @state.exceptions << ["msg", MSpecExampleError.new("boom!")]
+    @formatter.after(@state)
+    @out.should == "E"
+  end
+
+  it "prints an 'E' if there are mixed exceptions and exepctation failures" do
+    @state.exceptions << ["msg", ExpectationNotMetError.new("failed")]
+    @state.exceptions << ["msg", MSpecExampleError.new("boom!")]
+    @formatter.after(@state)
+    @out.should == "E"
+  end
+end
+
+describe DottedFormatter, "#finish" do
+  before :each do
+    @tally = mock("tally", :null_object => true)
+    TallyAction.stub!(:new).and_return(@tally)
+    @timer = mock("timer", :null_object => true)
+    TimerAction.stub!(:new).and_return(@timer)
+
+    $stdout = @out = IOStub.new
+    @state = SpecState.new("describe", "it")
+    MSpec.stub!(:register)
+    @formatter = DottedFormatter.new
+    @formatter.register
+  end
+
+  after :each do
+    $stdout = STDOUT
+  end
+
+  it "prints a failure message for an exception" do
+    @state.exceptions << ["msg", MSpecExampleError.new("broken")]
+    @formatter.after @state
+    @formatter.finish
+    @out.should =~ /^1\)\ndescribe it ERROR$/
+  end
+
+  it "prints a backtrace for an exception" do
+    @formatter.stub!(:backtrace).and_return("path/to/some/file.rb:35:in method")
+    @state.exceptions << ["msg", MSpecExampleError.new("broken")]
+    @formatter.after @state
+    @formatter.finish
+    @out.should =~ %r[path/to/some/file.rb:35:in method$]
+  end
+
+  it "prints a summary of elapsed time" do
+    @timer.should_receive(:format).and_return("Finished in 2.0 seconds")
+    @formatter.finish
+    @out.should =~ /^Finished in 2.0 seconds$/
+  end
+
+  it "prints a tally of counts" do
+    @tally.should_receive(:format).and_return("1 example, 0 failures")
+    @formatter.finish
+    @out.should =~ /^1 example, 0 failures$/
+  end
+
+  it "prints errors, backtraces, elapsed time, and tallies" do
+    @state.exceptions << ["msg", MSpecExampleError.new("broken")]
+    @formatter.stub!(:backtrace).and_return("path/to/some/file.rb:35:in method")
+    @timer.should_receive(:format).and_return("Finished in 2.0 seconds")
+    @tally.should_receive(:format).and_return("1 example, 0 failures")
+    @formatter.after @state
+    @formatter.finish
+    @out.should ==
+%[E
+
+1)
+describe it ERROR
+MSpecExampleError occurred during: msg
+MSpecExampleError: broken
+path/to/some/file.rb:35:in method
+
+Finished in 2.0 seconds
+
+1 example, 0 failures
+]
+  end
+end