rspec 0.8.2 → 0.9.0

data/spec/spec/package/bin_spec_spec.rb

@@ -0,0 +1,12 @@
+require "#{File.dirname(__FILE__)}/../../spec_helper"
+
+describe "The bin/spec script" do
+  it "should have no warnings" do
+    spec_path = "#{File.dirname(__FILE__)}/../../../bin/spec"
+    output = nil
+    IO.popen("ruby -w #{spec_path} --help 2>&1") do |io|
+      output = io.read
+    end
+    output.should_not =~ /warning/n
+  end
+end

data/spec/spec/runner/behaviour_runner_spec.rb

@@ -0,0 +1,114 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+module Spec
+  module Runner
+    describe BehaviourRunner do
+
+      it "should only run behaviours with at least one example" do
+        desired_context = mock("desired context")
+        desired_context.should_receive(:run)
+        desired_context.should_receive(:retain_examples_matching!)
+        desired_context.should_receive(:number_of_examples).twice.and_return(1)
+
+        other_context = mock("other context")
+        other_context.should_receive(:run).never
+        other_context.should_receive(:retain_examples_matching!)
+        other_context.should_receive(:number_of_examples).and_return(0)
+
+        reporter = mock("reporter")
+        options = Options.new
+        options.reporter = reporter
+        options.examples = ["desired context legal spec"]
+
+        runner = Spec::Runner::BehaviourRunner.new(options)
+        runner.add_behaviour(desired_context)
+        runner.add_behaviour(other_context)
+        reporter.should_receive(:start)
+        reporter.should_receive(:end)
+        reporter.should_receive(:dump)
+        runner.run([], false)
+      end
+
+      it "should dump even if Interrupt exception is occurred" do
+        behaviour = Spec::DSL::Behaviour.new("context") do
+          it "no error" do
+          end
+
+          it "should interrupt" do
+            raise Interrupt
+          end
+        end
+        
+        reporter = mock("reporter")
+        reporter.should_receive(:start)
+        reporter.should_receive(:add_behaviour).with("context")
+        reporter.should_receive(:example_started).twice
+        reporter.should_receive(:example_finished).twice
+        reporter.should_receive(:rspec_verify)
+        reporter.should_receive(:rspec_reset)
+        reporter.should_receive(:end)
+        reporter.should_receive(:dump)
+
+        options = Options.new
+        options.reporter = reporter
+        runner = Spec::Runner::BehaviourRunner.new(options)
+        runner.add_behaviour(behaviour)
+        runner.run([], false)
+      end
+
+      it "should heckle when options have heckle_runner" do
+        context = mock("context", :null_object => true)
+        context.should_receive(:number_of_examples).twice.and_return(1)
+        context.should_receive(:run).and_return(0)
+
+        reporter = mock("reporter")
+        reporter.should_receive(:start).with(1)
+        reporter.should_receive(:end)
+        reporter.should_receive(:dump).and_return(0)
+
+        heckle_runner = mock("heckle_runner")
+        heckle_runner.should_receive(:heckle_with)
+
+        options = Options.new
+        options.reporter = reporter
+        options.heckle_runner = heckle_runner
+
+        runner = Spec::Runner::BehaviourRunner.new(options)
+        runner.add_behaviour(context)
+        runner.run([], false)
+      end
+
+      it "should run specs backward if options.reverse is true" do
+        options = Options.new
+        options.reverse = true
+
+        reporter = mock("reporter")
+        reporter.should_receive(:start).with(3)
+        reporter.should_receive(:end)
+        reporter.should_receive(:dump).and_return(0)
+        options.reporter = reporter
+
+        runner = Spec::Runner::BehaviourRunner.new(options)
+        c1 = mock("c1")
+        c1.should_receive(:number_of_examples).twice.and_return(1)
+
+        c2 = mock("c2")
+        c2.should_receive(:number_of_examples).twice.and_return(2)
+        c2.should_receive(:run) do
+          c1.should_receive(:run)
+        end
+
+        runner.add_behaviour(c1)
+        runner.add_behaviour(c2)
+    
+        runner.run([], false)
+      end
+      
+      it "should yield global configuration" do
+        Spec::Runner.configure do |config|
+          config.should equal(Spec::Runner.configuration)
+        end
+      end
+    end
+  end
+end

data/spec/spec/runner/command_line_spec.rb

@@ -1,32 +1,32 @@
 require 'stringio'
-context "CommandLine" do
-  specify "should run directory" do
+describe "CommandLine" do
+  it "should run directory" do
     file = File.dirname(__FILE__) + '/../../../examples'
     err = StringIO.new
     out = StringIO.new
     Spec::Runner::CommandLine.run([file], err, out, false, true)
     
     out.rewind
-    out.read.should =~ /60 specifications, 0 failures/n
+    out.read.should =~ /74 examples, 0 failures/n
   end
 
-  specify "should run file" do
+  it "should run file" do
     file = File.dirname(__FILE__) + '/../../../examples/io_processor_spec.rb'
     err = StringIO.new
     out = StringIO.new
     Spec::Runner::CommandLine.run([file], err, out, false, true)
     
     out.rewind
-    out.read.should =~ /2 specifications, 0 failures/n
+    out.read.should =~ /2 examples, 0 failures/n
   end
 
-  specify "should raise when file does not exist" do
+  it "should raise when file does not exist" do
     file = File.dirname(__FILE__) + '/doesntexist'
     err = StringIO.new
     out = StringIO.new
 
     lambda {
       Spec::Runner::CommandLine.run([file], err, out, false, true)
-    }.should_raise
+    }.should raise_error
   end
-end
+end

data/spec/spec/runner/context_matching_spec.rb

@@ -1,27 +1,26 @@
 require File.dirname(__FILE__) + '/../../spec_helper.rb'
 
 module Spec
-  module Runner
-    context "ContextMatching" do
+  module DSL
+    describe "ContextMatching" do
 
-      setup do
+      before(:each) do
         @formatter = Spec::Mocks::Mock.new("formatter")
-        @context = Context.new("context") {}
-        @context_eval = @context.instance_eval { @context_eval_module }
+        @behaviour = Behaviour.new("context") {}
       end
 
-      specify "run all specs when spec is not specified" do
-        @context_eval.specify("spec1") {}
-        @context_eval.specify("spec2") {}
-        @context.run_single_spec("context")
-        @context.number_of_specs.should_equal(2)
+      it "run all specs when spec is not specified" do
+        @behaviour.it("spec1") {}
+        @behaviour.it("spec2") {}
+        @behaviour.retain_examples_matching!(["context"])
+        @behaviour.number_of_examples.should == 2
       end
 
-      specify "should only run specified specs when specified" do
-        @context_eval.specify("spec1") {}
-        @context_eval.specify("spec2") {}
-        @context.run_single_spec("context spec1")
-        @context.number_of_specs.should_equal(1)
+      it "should only run specified examples when specified" do
+        @behaviour.it("spec1") {}
+        @behaviour.it("spec2") {}
+        @behaviour.retain_examples_matching!(["context spec1"])
+        @behaviour.number_of_examples.should == 1
       end
     end
   end

data/spec/spec/runner/drb_command_line_spec.rb

@@ -1,10 +1,10 @@
 require 'stringio'
 require 'rbconfig'
 
-context "DrbCommandLine without running local server" do
+describe "DrbCommandLine without running local server" do
   
   unless Config::CONFIG['ruby_install_name'] == 'jruby'
-    specify "should print error when there is no running local server" do
+    it "should print error when there is no running local server" do
       err = StringIO.new
       out = StringIO.new
       Spec::Runner::DrbCommandLine.run(['--version'], err, out, false)
@@ -15,30 +15,30 @@ context "DrbCommandLine without running local server" do
   end    
 end
 
-context "DrbCommandLine with local server" do
+describe "DrbCommandLine with local server" do
 
   unless Config::CONFIG['ruby_install_name'] == 'jruby'  
-    context_setup do
+    before :all do
       create_dummy_spec_file
       DRb.start_service("druby://localhost:8989", Spec::Runner::CommandLine)
     end
     
-    context_teardown do
+    after :all do
       DRb.stop_service      
       File.delete(@dummy_spec_filename)
     end
 
-    specify "should run against local server" do
+    it "should run against local server" do
       out = run_spec_via_druby(['--version'])
       out.should =~ /RSpec/n
     end
     
-    specify "should output green colorized text when running with --colour option" do
+    it "should output green colorized text when running with --colour option" do
       out = run_spec_via_druby(["--colour", @dummy_spec_filename])
       out.should =~ /\e\[32m/n
     end
     
-    specify "should output red colorized text when running with -c option" do      
+    it "should output red colorized text when running with -c option" do      
       out = run_spec_via_druby(["-c", @dummy_spec_filename])
       out.should =~ /\e\[31m/n
     end
@@ -47,12 +47,12 @@ context "DrbCommandLine with local server" do
       @dummy_spec_filename = File.expand_path(File.dirname(__FILE__)) + '/_dummy_spec.rb'
       File.open(@dummy_spec_filename, 'w') do |f|
         f.write %{
-context "DUMMY CONTEXT for 'DrbCommandLine with -c option'" do
-  specify "should be output with green bar" do
-    true.should be(true)
+describe "DUMMY CONTEXT for 'DrbCommandLine with -c option'" do
+  it "should be output with green bar" do
+    true.should be_true
   end
 
-  specify "should be output with red bar" do
+  it "should be output with red bar" do
     violated("I wan to see a red bar!")
   end
 end

data/spec/spec/runner/execution_context_spec.rb

@@ -1,49 +1,28 @@
 require File.dirname(__FILE__) + '/../../spec_helper.rb'
 
-context "ExecutionContext" do
+describe "ExecutionContext" do
   
-  specify "should provide duck type" do
+  it "should provide duck_type()" do
     dt = duck_type(:length)
     dt.should be_an_instance_of(Spec::Mocks::DuckTypeArgConstraint)
     dt.matches?([]).should be_true
   end
 
-  specify "should violate on :violated" do
+  it "should violate when violated()" do
     lambda do
-      Spec::Runner::ExecutionContext.new(nil).violated
+      violated
     end.should raise_error(Spec::Expectations::ExpectationNotMetError)
   end
 
-  specify "should provide mock" do
+  it "should provide mock()" do
     mock("thing").should be_an_instance_of(Spec::Mocks::Mock)
   end
 
-  # TODO - the following two specs don't work when combined:
-  # specify "should provide stub" do
-  #   thing_stub = stub("thing", :a => "A", :b => "B").should be_an_instance_of(Spec::Mocks::Mock)
-  #   thing_stub.a.should == "A"
-  #   thing_stub.b.should == "B"
-  # end
-  # 
-  # TypeError in 'ExecutionContext should provide stub'
-  # ["a?", "as?"] is not a symbol
-  # /Users/david/projects/ruby/rspec/trunk/rspec/lib/spec/expectations/should/should.rb:66:in `send'
-  # /Users/david/projects/ruby/rspec/trunk/rspec/lib/spec/expectations/should/should.rb:66:in `__delegate_method_missing_to_target'
-  # /Users/david/projects/ruby/rspec/trunk/rspec/lib/spec/expectations/should/base.rb:53:in `method_missing'
-  # ./spec/spec/runner/execution_context_spec.rb:27:
-  # /Users/david/projects/ruby/rspec/trunk/rspec/lib/spec/runner/specification.rb:55:in `execute_spec'
-  # /Users/david/projects/ruby/rspec/trunk/rspec/lib/spec/runner/specification.rb:30:in `run'
-  # /Users/david/projects/ruby/rspec/trunk/rspec/lib/spec/runner/context.rb:57:in `run'
-  # /Users/david/projects/ruby/rspec/trunk/rspec/lib/spec/runner/context.rb:54:in `run'
-  # /Users/david/projects/ruby/rspec/trunk/rspec/lib/spec/runner/context_runner.rb:23:in `run'
-  # /Users/david/projects/ruby/rspec/trunk/rspec/lib/spec/runner/context_runner.rb:22:in `run'
-  # /Users/david/projects/ruby/rspec/trunk/rspec/lib/spec/runner/command_line.rb:27:in `run'
-  # bin/spec:4:
-  specify "should provide stub" do
-    thing_stub = stub("thing", :a => "A", :b => "B").should be_an_instance_of(Spec::Mocks::Mock)
+  it "should provide stub()" do
+    thing_stub = stub("thing").should be_an_instance_of(Spec::Mocks::Mock)
   end
   
-  specify "should add method stubs to stub" do
+  it "should add method stubs to stub()" do
     thing_stub = stub("thing", :a => "A", :b => "B")
     thing_stub.a.should == "A"
     thing_stub.b.should == "B"

data/spec/spec/runner/extensions/kernel_spec.rb

@@ -0,0 +1,36 @@
+require File.dirname(__FILE__) + '/../../../spec_helper.rb'
+
+describe Kernel, "when extended by rspec" do
+  it "should respond to :describe" do
+    Object.new.should respond_to(:describe)
+    Object.new.should respond_to(:context)
+  end
+end
+
+describe Kernel, " when creating behaviours with describe" do
+
+  it "should fail when no block given" do
+    lambda { describe "foo" }.should raise_error(ArgumentError)
+  end
+
+  it "should fail when no description given" do
+    lambda { describe do; end }.should raise_error(ArgumentError)
+  end
+end
+
+describe Kernel, "#respond_to" do
+  before(:each) do
+    @kernel_impersonator = Class.new do
+      include Kernel
+    end.new
+  end
+  
+  it "should return a Spec::Matchers::RespondTo" do
+    @kernel_impersonator.respond_to.should be_an_instance_of(Spec::Matchers::RespondTo)
+  end
+  
+  it "should pass the submitted names to the RespondTo instance" do
+    Spec::Matchers::RespondTo.should_receive(:new).with(:a,'b','c?')
+    @kernel_impersonator.respond_to(:a,'b','c?')
+  end
+end

data/spec/spec/runner/formatter/failing_behaviours_formatter_spec.rb

@@ -0,0 +1,27 @@
+require File.dirname(__FILE__) + '/../../../spec_helper.rb'
+
+module Spec
+  module Runner
+    module Formatter
+      describe "FailingBehavioursFormatter" do
+        before(:each) do
+          @io = StringIO.new
+          @formatter = FailingBehavioursFormatter.new(@io)
+        end
+
+        it "should add example name for each failure" do
+          @formatter.add_behaviour("b 1")
+          @formatter.example_failed("e 1", nil, Reporter::Failure.new(nil, RuntimeError.new))
+          @formatter.add_behaviour("b 2")
+          @formatter.example_failed("e 2", nil, Reporter::Failure.new(nil, RuntimeError.new))
+          @formatter.example_failed("e 3", nil, Reporter::Failure.new(nil, RuntimeError.new))
+          @io.string.should eql(<<-EOF
+b 1
+b 2
+EOF
+)
+        end
+      end
+    end
+  end
+end

data/spec/spec/runner/formatter/failing_examples_formatter_spec.rb

@@ -0,0 +1,28 @@
+require File.dirname(__FILE__) + '/../../../spec_helper.rb'
+
+module Spec
+  module Runner
+    module Formatter
+      describe "FailingExamplesFormatter" do
+        before(:each) do
+          @io = StringIO.new
+          @formatter = FailingExamplesFormatter.new(@io)
+        end
+
+        it "should add example name for each failure" do
+          @formatter.add_behaviour("b 1")
+          @formatter.example_failed("e 1", nil, Reporter::Failure.new(nil, RuntimeError.new))
+          @formatter.add_behaviour("b 2")
+          @formatter.example_failed("e 2", nil, Reporter::Failure.new(nil, RuntimeError.new))
+          @formatter.example_failed("e 3", nil, Reporter::Failure.new(nil, RuntimeError.new))
+          @io.string.should eql(<<-EOF
+b 1 e 1
+b 2 e 2
+b 2 e 3
+EOF
+)
+        end
+      end
+    end
+  end
+end

data/spec/spec/runner/formatter/html_formatter_spec.rb

@@ -1,14 +1,15 @@
 require File.dirname(__FILE__) + '/../../../spec_helper.rb'
 require 'stringio'
+describe "HtmlFormatter" do
+  ['--diff', '--dry-run'].each do |opt|
+    it "should produce HTML identical to the one we designed manually with #{opt}" do
+      root = File.expand_path(File.dirname(__FILE__) + '/../../../..')
+      suffix = PLATFORM == 'java' ? '-jruby' : ''
+      expected_file = File.dirname(__FILE__) + "/html_formatted-#{VERSION}#{suffix}.html"
+      raise "There is no HTML file with expected content for this platform: #{expected_file}" unless File.file?(expected_file)
+      expected_html = File.read(expected_file)
+      raise "There should be no absolute paths in html_formatted.html!!" if expected_html =~ /\/Users/n
 
-context "HtmlFormatter" do
-  specify "should produce HTML identical to the one we designed manually" do
-    root = File.expand_path(File.dirname(__FILE__) + '/../../../..')
-    expected_file = File.dirname(__FILE__) + "/html_formatted-#{VERSION}.html"
-    expected_html = File.read(expected_file)
-    raise "There should be no absolute paths in html_formatted.html!!" if expected_html =~ /\/Users/n
-    
-    ['--diff', '--dry-run'].each do |opt|
       Dir.chdir(root) do
         args = ['failing_examples/mocking_example.rb', 'failing_examples/diffing_spec.rb', 'examples/stubbing_example.rb', '--format', 'html', opt]
         err = StringIO.new