rspec 1.0.8 → 1.1.0

data/spec/spec/{dsl → example}/example_matcher_spec.rb

@@ -1,7 +1,7 @@
 require File.dirname(__FILE__) + '/../../spec_helper.rb'
 
 module Spec
-  module DSL
+  module Example
     module ExampleMatcherSpecHelper
       class MatchDescription
         def initialize(description)
@@ -25,32 +25,37 @@ module Spec
       end
     end
 
-    describe ExampleMatcher do
+    describe ExampleMatcher, "#matches?" do
       include ExampleMatcherSpecHelper
       
-      it "should match correct behaviour and example" do
-        matcher = ExampleMatcher.new("behaviour", "example")
-        matcher.should match_description("behaviour example")
+      it "should match correct example_group and example" do
+        matcher = ExampleMatcher.new("example_group", "example")
+        matcher.should match_description("example_group example")
       end
       
       it "should not match wrong example" do
-        matcher = ExampleMatcher.new("behaviour", "other example")
-        matcher.should_not match_description("behaviour example")
+        matcher = ExampleMatcher.new("example_group", "other example")
+        matcher.should_not match_description("example_group example")
       end
       
-      it "should not match wrong behaviour" do
-        matcher = ExampleMatcher.new("other behaviour", "example")
-        matcher.should_not match_description("behaviour example")
+      it "should not match wrong example_group" do
+        matcher = ExampleMatcher.new("other example_group", "example")
+        matcher.should_not match_description("example_group example")
       end
       
       it "should match example only" do
-        matcher = ExampleMatcher.new("behaviour", "example")
+        matcher = ExampleMatcher.new("example_group", "example")
         matcher.should match_description("example")
       end
-      
-      it "should match behaviour only" do
-        matcher = ExampleMatcher.new("behaviour", "example")
-        matcher.should match_description("behaviour")
+
+      it "should match example_group only" do
+        matcher = ExampleMatcher.new("example_group", "example")
+        matcher.should match_description("example_group")
+      end
+
+      it "should match example_group ending with before(:all)" do
+        matcher = ExampleMatcher.new("example_group", "example")
+        matcher.should match_description("example_group before(:all)")
       end
       
       it "should escape regexp chars" do
@@ -58,13 +63,13 @@ module Spec
         matcher.should_not match_description("con p")
       end
       
-      it "should match when behaviour is modularized" do
+      it "should match when example_group is modularized" do
         matcher = ExampleMatcher.new("MyModule::MyClass", "example")
         matcher.should match_description("MyClass example")
       end      
     end
 
-    describe ExampleMatcher, "normal case" do
+    describe ExampleMatcher, "#matches? normal case" do
       it "matches when passed in example matches" do
         matcher = ExampleMatcher.new("Foo", "bar")
         matcher.matches?(["no match", "Foo bar"]).should == true
@@ -76,7 +81,7 @@ module Spec
       end
     end
 
-    describe ExampleMatcher, "where description has '::' in it" do
+    describe ExampleMatcher, "#matches? where description has '::' in it" do
       it "matches when passed in example matches" do
         matcher = ExampleMatcher.new("Foo::Bar", "baz")
         matcher.matches?(["no match", "Foo::Bar baz"]).should == true

data/spec/spec/example/example_methods_spec.rb

@@ -0,0 +1,75 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+module Spec
+  module Example
+    module ModuleThatIsReopened
+    end
+
+    module ExampleMethods
+      include ModuleThatIsReopened
+    end
+
+    module ModuleThatIsReopened
+      def module_that_is_reopened_method
+      end
+    end
+
+    describe "ExampleMethods with an included module that is reopened" do
+      it "should have repoened methods" do
+        method(:module_that_is_reopened_method).should_not be_nil
+      end
+    end
+
+    describe ExampleMethods, "lifecycle" do
+      before do
+        @options = ::Spec::Runner::Options.new(StringIO.new, StringIO.new)
+        @options.formatters << mock("formatter", :null_object => true)
+        @options.backtrace_tweaker = mock("backtrace_tweaker", :null_object => true)
+        @reporter = FakeReporter.new(@options)
+        @options.reporter = @reporter
+
+        ExampleMethods.before_all_parts.should == []
+        ExampleMethods.before_each_parts.should == []
+        ExampleMethods.after_each_parts.should == []
+        ExampleMethods.after_all_parts.should == []
+        def ExampleMethods.count
+          @count ||= 0
+          @count = @count + 1
+          @count
+        end
+      end
+
+      after do
+        ExampleMethods.instance_variable_set("@before_all_parts", [])
+        ExampleMethods.instance_variable_set("@before_each_parts", [])
+        ExampleMethods.instance_variable_set("@after_each_parts", [])
+        ExampleMethods.instance_variable_set("@after_all_parts", [])
+      end
+
+      it "should pass before and after callbacks to all ExampleGroup subclasses" do
+        ExampleMethods.before(:all) do
+          ExampleMethods.count.should == 1
+        end
+
+        ExampleMethods.before(:each) do
+          ExampleMethods.count.should == 2
+        end
+
+        ExampleMethods.after(:each) do
+          ExampleMethods.count.should == 3
+        end
+
+        ExampleMethods.after(:all) do
+          ExampleMethods.count.should == 4
+        end
+
+        @example_group = Class.new(ExampleGroup) do
+          it "should use ExampleMethods callbacks" do
+          end
+        end
+        @example_group.run
+        ExampleMethods.count.should == 5
+      end
+    end
+  end
+end

data/spec/spec/example/example_runner_spec.rb

@@ -0,0 +1,194 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+module Spec
+  module Example
+    # describe "Spec::Example::ExampleRunner", "#run", :shared => true do
+    #   before(:each) do
+    #     @options = ::Spec::Runner::Options.new(StringIO.new, StringIO.new)
+    #     @reporter = ::Spec::Runner::Reporter.new(@options)
+    #     @options.reporter = @reporter
+    #     @example_group_class = Class.new(ExampleGroup) do
+    #       plugin_mock_framework
+    #       describe("Some Examples")
+    #     end
+    #   end
+    # 
+    #   def create_runner(example_definition)
+    #     example = @example_group_class.new(example_definition)
+    #     runner = ExampleGroup.new(@options, example)
+    #     runner.stub!(:verify_mocks)
+    #     runner.stub!(:teardown_mocks)
+    #     runner
+    #   end
+    # end
+    # 
+    # describe ExampleRunner, "#run with blank passing example" do
+    #   it_should_behave_like "Spec::Example::ExampleRunner#run"
+    # 
+    #   before do
+    #     @e = @example_group_class.it("example") {}
+    #     @runner = create_runner(@e)
+    #   end
+    #   
+    #   it "should send reporter example_started" do
+    #     @reporter.should_receive(:example_started).with(equal(@e))
+    #     @runner.run
+    #   end
+    # 
+    #   it "should report its name for dry run" do
+    #     @options.dry_run = true
+    #     @reporter.should_receive(:example_finished).with(equal(@e), nil)
+    #     @runner.run
+    #   end
+    # 
+    #   it "should report success" do
+    #     @reporter.should_receive(:example_finished).with(equal(@e), nil)
+    #     @runner.run
+    #   end
+    # end
+    # 
+    # describe ExampleRunner, "#run with a failing example" do
+    #   predicate_matchers[:is_a] = [:is_a?]
+    #   it_should_behave_like "Spec::Example::ExampleRunner#run"
+    # 
+    #   before do
+    #     @e = @example_group_class.it("example") do
+    #       (2+2).should == 5
+    #     end
+    #     @runner = create_runner(@e)
+    #   end
+    # 
+    #   it "should report failure due to failure" do
+    #     @reporter.should_receive(:example_finished).with(
+    #       equal(@e),
+    #       is_a(Spec::Expectations::ExpectationNotMetError)
+    #     )
+    #     @runner.run
+    #   end
+    # end
+    # 
+    # describe ExampleRunner, "#run with a erroring example" do
+    #   it_should_behave_like "Spec::Example::ExampleRunner#run"
+    # 
+    #   before do
+    #     @error = error = NonStandardError.new("in body")
+    #     @example_definition = @example_group_class.it("example") do
+    #       raise(error)
+    #     end
+    #     @runner = create_runner(@example_definition)
+    #   end
+    # 
+    #   it "should report failure due to error" do
+    #     @reporter.should_receive(:example_finished).with(
+    #       equal(@example_definition),
+    #       @error
+    #     )
+    #     @runner.run
+    #   end
+    # 
+    #   it "should run after_each block" do
+    #     @example_group_class.after(:each) do
+    #       raise("in after_each")
+    #     end
+    #     @reporter.should_receive(:example_finished) do |example_definition, error|
+    #       example_definition.should equal(@example_definition)
+    #       error.message.should eql("in body")
+    #     end
+    #     @runner.run
+    #   end      
+    # end
+    # 
+    # describe ExampleRunner, "#run where after_each fails" do
+    #   it_should_behave_like "Spec::Example::ExampleRunner#run"
+    # 
+    #   before do
+    #     @example_ran = example_ran = false
+    #     @example_definition = @example_group_class.it("should not run") do
+    #       example_ran = true
+    #     end
+    #     @runner = create_runner(@example_definition)
+    #     @example_group_class.after(:each) { raise(NonStandardError.new("in after_each")) }
+    #   end
+    # 
+    #   it "should report failure location when in after_each" do
+    #     @reporter.should_receive(:example_finished) do |example_definition, error|
+    #       example_definition.should equal(@example_definition)
+    #       error.message.should eql("in after_each")
+    #     end
+    #     @runner.run
+    #   end
+    # end
+    # 
+    # describe ExampleRunner, "#run with use cases" do
+    #   predicate_matchers[:is_a] = [:is_a?]
+    #   it_should_behave_like "Spec::Example::ExampleRunner#run"
+    # 
+    #   it "should report NO NAME when told to use generated description with --dry-run" do
+    #     @options.dry_run = true
+    #     example_definition = @example_group_class.it() do
+    #       5.should == 5
+    #     end
+    #     runner = create_runner(example_definition)
+    # 
+    #     @reporter.should_receive(:example_finished) do |example_definition, error|
+    #       example_definition.description.should == "NO NAME (Because of --dry-run)"
+    #      end
+    #     runner.run
+    #   end
+    # 
+    #   it "should report given name if present with --dry-run" do
+    #     @options.dry_run = true
+    #     example_definition = @example_group_class.it("example name") do
+    #       5.should == 5
+    #     end
+    #     runner = create_runner(example_definition)
+    # 
+    #     @reporter.should_receive(:example_finished) do |example_definition, error|
+    #       example_definition.description.should == "example name"
+    #      end
+    #     runner.run
+    #   end
+    # 
+    #   it "should report NO NAME when told to use generated description with no expectations" do
+    #     example_definition = @example_group_class.it() {}
+    #     runner = create_runner(example_definition)
+    #     @reporter.should_receive(:example_finished) do |example, error|
+    #       example.description.should == "NO NAME (Because there were no expectations)"
+    #     end
+    #     runner.run
+    #   end
+    # 
+    #   it "should report NO NAME when told to use generated description and matcher fails" do
+    #     example_definition = @example_group_class.it() do
+    #       5.should "" # Has no matches? method..
+    #     end
+    #     runner = create_runner(example_definition)
+    # 
+    #     @reporter.should_receive(:example_finished) do |example, error|
+    #       example_definition.description.should == "NO NAME (Because of Error raised in matcher)"
+    #     end
+    #     runner.run
+    #   end
+    # 
+    #   it "should report generated description when told to and it is available" do
+    #     example_definition = @example_group_class.it() {
+    #       5.should == 5
+    #     }
+    #     runner = create_runner(example_definition)
+    #     
+    #     @reporter.should_receive(:example_finished) do |example_definition, error|
+    #       example_definition.description.should == "should == 5"
+    #     end
+    #     runner.run
+    #   end
+    # 
+    #   it "should unregister description_generated callback (lest a memory leak should build up)" do
+    #     example_definition = @example_group_class.it("something")
+    #     runner = create_runner(example_definition)
+    # 
+    #     Spec::Matchers.should_receive(:example_finished)
+    #     runner.run
+    #   end
+    # end
+  end
+end

data/spec/spec/example/example_spec.rb

@@ -0,0 +1,53 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+module Spec
+  module Example
+    # describe Example do
+    #   before(:each) do
+    #     @example = Example.new "example" do
+    #       foo
+    #     end
+    #   end
+    #   
+    #   it "should tell you its docstring" do
+    #     @example.description.should == "example"
+    #   end
+    # 
+    #   it "should execute its block in the context provided" do
+    #     context = Class.new do
+    #       def foo
+    #         "foo"
+    #       end
+    #     end.new
+    #     @example.run_in(context).should == "foo"
+    #   end
+    # end
+    # 
+    # describe Example, "#description" do
+    #   it "should default to NO NAME when not passed anything when there are no matchers" do
+    #     example = Example.new {}
+    #     example.run_in(Object.new)
+    #     example.description.should == "NO NAME"
+    #   end
+    # 
+    #   it "should default to NO NAME description (Because of --dry-run) when passed nil and there are no matchers" do
+    #     example = Example.new(nil) {}
+    #     example.run_in(Object.new)
+    #     example.description.should == "NO NAME"
+    #   end
+    # 
+    #   it "should allow description to be overridden" do
+    #     example = Example.new("Test description")
+    #     example.description.should == "Test description"
+    #   end
+    # 
+    #   it "should use description generated from matcher when there is no passed in description" do
+    #     example = Example.new(nil) do
+    #       1.should == 1
+    #     end
+    #     example.run_in(Object.new)
+    #     example.description.should == "should == 1"
+    #   end
+    # end
+  end
+end

data/spec/spec/example/nested_example_group_spec.rb

@@ -0,0 +1,59 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+module Spec
+  module Example
+    describe 'Nested Example Groups' do
+      parent = self
+      
+      def count
+        @count ||= 0
+        @count = @count + 1
+        @count
+      end
+
+      before(:all) do
+        count.should == 1
+      end
+
+      before(:all) do
+        count.should == 2
+      end
+
+      before(:each) do
+        count.should == 3
+      end
+
+      before(:each) do
+        count.should == 4
+      end
+
+      it "should run before(:all), before(:each), example, after(:each), after(:all) in order" do
+        count.should == 5
+      end
+
+      after(:each) do
+        count.should == 7
+      end
+
+      after(:each) do
+        count.should == 6
+      end
+
+      after(:all) do
+        count.should == 9
+      end
+
+      after(:all) do
+        count.should == 8
+      end
+
+      describe 'nested example group' do
+        self.superclass.should == parent
+        
+        it "should run all before and after callbacks" do
+          count.should == 5
+        end
+      end
+    end
+  end
+end