rspec-core 2.6.4 → 2.7.0.rc1

data/spec/rspec/core/configuration_spec.rb

@@ -71,6 +71,18 @@ module RSpec::Core
         config.should_receive(:require).with('rspec/core/mocking/with_absolutely_nothing')
         config.mock_framework = :crazy_new_mocking_framework_ive_not_yet_heard_of
       end
+
+      context 'when there are already some example groups defined' do
+        before(:each) do
+          RSpec.world.stub(:example_groups).and_return([double.as_null_object])
+        end
+
+        it 'raises an error since this setting must be applied before any groups are defined' do
+          expect {
+            config.mock_framework = :rspec
+          }.to raise_error(/must be configured before any example groups are defined/)
+        end
+      end
     end
 
     describe "#mock_with" do
@@ -109,6 +121,18 @@ module RSpec::Core
           config.expect_with :not_supported
         end.to raise_error(ArgumentError)
       end
+
+      context 'when there are already some example groups defined' do
+        before(:each) do
+          RSpec.world.stub(:example_groups).and_return([double.as_null_object])
+        end
+
+        it 'raises an error since this setting must be applied before any groups are defined' do
+          expect {
+            config.expect_with :rspec
+          }.to raise_error(/must be configured before any example groups are defined/)
+        end
+      end
     end
 
     describe "#expecting_with_rspec?" do
@@ -145,22 +169,47 @@ module RSpec::Core
 
     describe "#files_to_run" do
       it "loads files not following pattern if named explicitly" do
-        file = "./spec/rspec/core/resources/a_bar.rb"
-        config.files_or_directories_to_run = file
-        config.files_to_run.should == [file]
+        config.files_or_directories_to_run = "spec/rspec/core/resources/a_bar.rb"
+        config.files_to_run.should eq([      "spec/rspec/core/resources/a_bar.rb"])
+      end
+
+      it "prevents repitition of dir when start of the pattern" do
+        config.pattern = "spec/**/a_spec.rb"
+        config.files_or_directories_to_run = "spec"
+        config.files_to_run.should eq(["spec/rspec/core/resources/a_spec.rb"])
+      end
+
+      it "does not prevent repitition of dir when later of the pattern" do
+        config.pattern = "rspec/**/a_spec.rb"
+        config.files_or_directories_to_run = "spec"
+        config.files_to_run.should eq(["spec/rspec/core/resources/a_spec.rb"])
       end
 
       context "with default pattern" do
         it "loads files named _spec.rb" do
-          dir = "./spec/rspec/core/resources"
-          config.files_or_directories_to_run = dir
-          config.files_to_run.should == ["#{dir}/a_spec.rb"]
+          dir = "spec/rspec/core/resources"
+          config.files_or_directories_to_run = "spec/rspec/core/resources"
+          config.files_to_run.should eq([      "spec/rspec/core/resources/a_spec.rb"])
         end
 
         it "loads files in Windows" do
           file = "C:\\path\\to\\project\\spec\\sub\\foo_spec.rb"
           config.files_or_directories_to_run = file
-          config.files_to_run.should == [file]
+          config.files_to_run.should eq([file])
+        end
+      end
+      
+      context "with default default_path" do
+        it "loads files in the default path when run by rspec" do
+          config.stub(:command) { 'rspec' }
+          config.files_or_directories_to_run = []
+          config.files_to_run.should_not be_empty
+        end
+
+        it "does not load files in the default path when run by ruby" do
+          config.stub(:command) { 'ruby' }
+          config.files_or_directories_to_run = []
+          config.files_to_run.should be_empty
         end
       end
     end
@@ -209,9 +258,9 @@ module RSpec::Core
     end
 
     describe "path with line number" do
-      it "assigns the line number as the filter" do
+      it "assigns the line number as a location filter" do
         config.files_or_directories_to_run = "path/to/a_spec.rb:37"
-        config.filter.should == {:line_number => 37}
+        config.filter.should eq({:locations => {File.expand_path("path/to/a_spec.rb") => [37]}})
       end
     end
 
@@ -221,10 +270,42 @@ module RSpec::Core
         config.full_description = "foo"
         config.filter.should_not have_key(:focused)
       end
+    end
 
-      it "assigns the example name as the filter on description" do
-        config.full_description = "foo"
-        config.filter.should == {:full_description => /foo/}
+    context "with line number" do
+
+      it "assigns the file and line number as a location filter" do
+        config.files_or_directories_to_run = "path/to/a_spec.rb:37"
+        config.filter.should eq({:locations => {File.expand_path("path/to/a_spec.rb") => [37]}})
+      end
+
+      it "assigns multiple files with line numbers as location filters" do
+        config.files_or_directories_to_run = "path/to/a_spec.rb:37", "other_spec.rb:44"
+        config.filter.should eq({:locations => {File.expand_path("path/to/a_spec.rb") => [37],
+                                                File.expand_path("other_spec.rb") => [44]}})
+      end
+
+      it "assigns files with multiple line numbers as location filters" do
+        config.files_or_directories_to_run = "path/to/a_spec.rb:37", "path/to/a_spec.rb:44"
+        config.filter.should eq({:locations => {File.expand_path("path/to/a_spec.rb") => [37, 44]}})
+      end
+    end
+
+    context "with multiple line numbers" do
+      it "assigns the file and line numbers as a location filter" do
+        config.files_or_directories_to_run = "path/to/a_spec.rb:1:3:5:7"
+        config.filter.should eq({:locations => {File.expand_path("path/to/a_spec.rb") => [1,3,5,7]}})
+      end
+    end
+
+    it "assigns the example name as the filter on description" do
+      config.full_description = "foo"
+      config.filter.should eq({:full_description => /foo/})
+    end
+    
+    describe "#default_path" do
+      it 'defaults to "spec"' do
+        config.default_path.should eq('spec')
       end
     end
 
@@ -251,7 +332,7 @@ module RSpec::Core
 
           group = ExampleGroup.describe('does like, stuff and junk', :magic_key => :include) { }
           group.should_not respond_to(:you_call_this_a_blt?)
-          group.new.you_call_this_a_blt?.should == "egad man, where's the mayo?!?!?"
+          group.new.you_call_this_a_blt?.should eq("egad man, where's the mayo?!?!?")
         end
       end
 
@@ -263,7 +344,7 @@ module RSpec::Core
 
           group = ExampleGroup.describe('does like, stuff and junk', :magic_key => :include) { }
           group.should_not respond_to(:you_call_this_a_blt?)
-          group.new.you_call_this_a_blt?.should == "egad man, where's the mayo?!?!?"
+          group.new.you_call_this_a_blt?.should eq("egad man, where's the mayo?!?!?")
         end
       end
 
@@ -468,29 +549,29 @@ module RSpec::Core
     describe "#filter_run" do
       it_behaves_like "metadata hash builder" do
         def metadata_hash(*args)
-          config.filter_run *args
+          config.filter_run(*args)
           config.filter
         end
       end
 
       it "sets the filter" do
         config.filter_run :focus => true
-        config.filter[:focus].should == true
+        config.filter[:focus].should be(true)
       end
 
       it "merges with existing filters" do
         config.filter_run :filter1 => true
         config.filter_run :filter2 => false
 
-        config.filter[:filter1].should == true
-        config.filter[:filter2].should == false
+        config.filter[:filter1].should be(true)
+        config.filter[:filter2].should be(false)
       end
 
-      it "warns if :line_number is already a filter" do
-        config.filter_run :line_number => 100
+      it "warns if :line_numbers is already a filter" do
+        config.filter_run :line_numbers => [100]
         config.should_receive(:warn).with(
           "Filtering by {:focus=>true} is not possible since you " \
-          "are already filtering by {:line_number=>100}"
+          "are already filtering by {:line_numbers=>[100]}"
         )
         config.filter_run :focus => true
       end
@@ -508,22 +589,22 @@ module RSpec::Core
     describe "#filter_run_excluding" do
       it_behaves_like "metadata hash builder" do
         def metadata_hash(*args)
-          config.filter_run_excluding *args
+          config.filter_run_excluding(*args)
           config.exclusion_filter
         end
       end
 
       it "sets the filter" do
         config.filter_run_excluding :slow => true
-        config.exclusion_filter[:slow].should == true
+        config.exclusion_filter[:slow].should be(true)
       end
 
       it "merges with existing filters" do
         config.filter_run_excluding :filter1 => true
         config.filter_run_excluding :filter2 => false
 
-        config.exclusion_filter[:filter1].should == true
-        config.exclusion_filter[:filter2].should == false
+        config.exclusion_filter[:filter1].should be(true)
+        config.exclusion_filter[:filter2].should be(false)
       end
     end
 
@@ -574,24 +655,24 @@ module RSpec::Core
       end
     end
 
-    describe "#line_number=" do
+    describe "line_numbers=" do
       before { config.stub(:warn) }
 
-      it "sets the line number" do
-        config.line_number = '37'
-        config.filter.should == {:line_number => 37}
+      it "sets the line numbers" do
+        config.line_numbers = ['37']
+        config.filter.should eq({:line_numbers => [37]})
       end
 
       it "overrides :focused" do
         config.filter_run :focused => true
-        config.line_number = '37'
-        config.filter.should == {:line_number => 37}
+        config.line_numbers = ['37']
+        config.filter.should eq({:line_numbers => [37]})
       end
 
       it "prevents :focused" do
-        config.line_number = '37'
+        config.line_numbers = ['37']
         config.filter_run :focused => true
-        config.filter.should == {:line_number => 37}
+        config.filter.should eq({:line_numbers => [37]})
       end
     end
 
@@ -599,14 +680,14 @@ module RSpec::Core
       context "given true" do
         it "clears the backtrace clean patterns" do
           config.full_backtrace = true
-          config.backtrace_clean_patterns.should == []
+          config.backtrace_clean_patterns.should eq([])
         end
       end
 
       context "given false" do
         it "restores backtrace clean patterns" do
           config.full_backtrace = false
-          config.backtrace_clean_patterns.should == RSpec::Core::Configuration::DEFAULT_BACKTRACE_PATTERNS
+          config.backtrace_clean_patterns.should eq(RSpec::Core::Configuration::DEFAULT_BACKTRACE_PATTERNS)
         end
       end
 
@@ -619,6 +700,23 @@ module RSpec::Core
       end
     end
 
+    describe "#cleaned_from_backtrace? defaults" do
+      it "returns true for rspec files" do
+        config.cleaned_from_backtrace?("lib/rspec/core.rb").
+          should be_true
+      end
+
+      it "returns true for spec_helper" do
+        config.cleaned_from_backtrace?("spec/spec_helper.rb").
+          should be_true
+      end
+
+      it "returns true for java files (for JRuby)" do
+        config.cleaned_from_backtrace?("org/jruby/RubyArray.java:2336").
+          should be_true
+      end
+    end
+
     describe "#debug=true" do
       before do
         if defined?(Debugger)
@@ -733,12 +831,12 @@ module RSpec::Core
 
         it "delegates the getter to the other option" do
           config.another_custom_option = "this value"
-          config.custom_option.should == "this value"
+          config.custom_option.should eq("this value")
         end
 
         it "delegates the setter to the other option" do
           config.custom_option = "this value"
-          config.another_custom_option.should == "this value"
+          config.another_custom_option.should eq("this value")
         end
 
         it "delegates the predicate to the other option" do
@@ -805,5 +903,18 @@ module RSpec::Core
       end
     end
 
+    describe "#reset" do
+      it "clears the reporter" do
+        config.reporter.should_not be_nil
+        config.reset
+        config.instance_variable_get("@reporter").should be_nil
+      end
+
+      it "clears the formatters" do
+        config.add_formatter "doc"
+        config.reset
+        config.formatters.should be_empty
+      end
+    end
   end
 end

data/spec/rspec/core/deprecations_spec.rb

@@ -9,7 +9,7 @@ describe "deprecations" do
 
     it "returns RSpec" do
       RSpec.stub(:warn_deprecation)
-      Spec.should == RSpec
+      Spec.should eq(RSpec)
     end
 
     it "doesn't include backward compatibility in const_missing backtrace" do
@@ -32,7 +32,7 @@ describe "deprecations" do
 
       it "delegates to example" do
         RSpec.stub(:warn_deprecation)
-        running_example.should == example
+        running_example.should eq(example)
       end
     end
   end

data/spec/rspec/core/drb_command_line_spec.rb

@@ -1,6 +1,6 @@
 require "spec_helper"
 
-describe "::DRbCommandLine", :ruby => "!jruby" do
+describe "::DRbCommandLine", :type => :drb, :unless => RUBY_PLATFORM == 'java' do
   let(:config) { RSpec::Core::Configuration.new }
   let(:out)    { StringIO.new }
   let(:err)    { StringIO.new }
@@ -41,14 +41,14 @@ describe "::DRbCommandLine", :ruby => "!jruby" do
     context "without RSPEC_DRB environment variable set" do
       it "defaults to 8989" do
         with_RSPEC_DRB_set_to(nil) do
-          command_line([]).drb_port.should == 8989
+          command_line([]).drb_port.should eq(8989)
         end
       end
 
       it "sets the DRb port" do
         with_RSPEC_DRB_set_to(nil) do
-          command_line(["--drb-port", "1234"]).drb_port.should == 1234
-          command_line(["--drb-port", "5678"]).drb_port.should == 5678
+          command_line(["--drb-port", "1234"]).drb_port.should eq(1234)
+          command_line(["--drb-port", "5678"]).drb_port.should eq(5678)
         end
       end
     end
@@ -58,7 +58,7 @@ describe "::DRbCommandLine", :ruby => "!jruby" do
       context "without config variable set" do
         it "uses RSPEC_DRB value" do
           with_RSPEC_DRB_set_to('9000') do
-            command_line([]).drb_port.should == "9000"
+            command_line([]).drb_port.should eq("9000")
           end
         end
       end
@@ -66,7 +66,7 @@ describe "::DRbCommandLine", :ruby => "!jruby" do
       context "and config variable set" do
         it "uses configured value" do
           with_RSPEC_DRB_set_to('9000') do
-            command_line(%w[--drb-port 5678]).drb_port.should == 5678
+            command_line(%w[--drb-port 5678]).drb_port.should eq(5678)
           end
         end
       end

data/spec/rspec/core/example_group_spec.rb

@@ -28,12 +28,12 @@ module RSpec::Core
 
       it 'processes string args as part of the description' do
         group = ExampleGroup.describe("some", "separate", "strings")
-        group.description.should == "some separate strings"
+        group.description.should eq("some separate strings")
       end
 
       it 'processes symbol args as part of the description' do
         group = ExampleGroup.describe(:some, :separate, :symbols)
-        group.description.should == "some separate symbols"
+        group.description.should eq("some separate symbols")
       end
     end
 
@@ -48,7 +48,7 @@ module RSpec::Core
       end
 
       it 'treats the first argument as part of the description when it is a symbol' do
-        group.description.should == "symbol"
+        group.description.should eq("symbol")
       end
     end
 
@@ -95,7 +95,7 @@ module RSpec::Core
               describe("grandchild 2") {}
             end
           end
-          group.descendants.size.should == 4
+          group.descendants.size.should eq(4)
         end
       end
     end
@@ -104,7 +104,7 @@ module RSpec::Core
       it "is known by parent" do
         parent = ExampleGroup.describe
         child = parent.describe
-        parent.children.should == [child]
+        parent.children.should eq([child])
       end
 
       it "is not registered in world" do
@@ -112,7 +112,7 @@ module RSpec::Core
         parent = ExampleGroup.describe
         world.register(parent)
         child = parent.describe
-        world.example_groups.should == [parent]
+        world.example_groups.should eq([parent])
       end
     end
 
@@ -128,7 +128,7 @@ module RSpec::Core
             group.stub(:world) { world }
             all_examples = [ group.example("first"), group.example("second") ]
 
-            group.filtered_examples.should == all_examples
+            group.filtered_examples.should eq(all_examples)
           end
 
           it "includes examples directly matching filter" do
@@ -140,7 +140,7 @@ module RSpec::Core
             ]
             group.example("third (not-filtered)")
 
-            group.filtered_examples.should == filtered_examples
+            group.filtered_examples.should eq(filtered_examples)
           end
         end
 
@@ -163,7 +163,7 @@ module RSpec::Core
             ]
             unfiltered_example = group.example("third (not-filtered)")
 
-            group.filtered_examples.should == [unfiltered_example]
+            group.filtered_examples.should eq([unfiltered_example])
           end
         end
       end
@@ -239,7 +239,7 @@ module RSpec::Core
           group = ExampleGroup.describe
           group.stub(:world) { world }
           example = group.example("does something")
-          group.filtered_examples.should == [example]
+          group.filtered_examples.should eq([example])
         end
       end
 
@@ -249,7 +249,7 @@ module RSpec::Core
           group = ExampleGroup.describe
           group.stub(:world) { world }
           example = group.example("does something")
-          group.filtered_examples.should == []
+          group.filtered_examples.should eq([])
         end
       end
     end
@@ -258,7 +258,7 @@ module RSpec::Core
 
       context "with a constant as the first parameter" do
         it "is that constant" do
-          ExampleGroup.describe(Object) { }.describes.should == Object
+          ExampleGroup.describe(Object) { }.describes.should eq(Object)
         end
       end
 
@@ -308,7 +308,7 @@ module RSpec::Core
     describe '#description' do
       it "grabs the description from the metadata" do
         group = ExampleGroup.describe(Object, "my desc") { }
-        group.description.should == group.metadata[:example_group][:description]
+        group.description.should eq(group.metadata[:example_group][:description])
       end
     end
 
@@ -318,15 +318,15 @@ module RSpec::Core
       end
 
       it "adds the the file_path to metadata" do
-        ExampleGroup.describe(Object) { }.metadata[:example_group][:file_path].should == __FILE__
+        ExampleGroup.describe(Object) { }.metadata[:example_group][:file_path].should eq(__FILE__)
       end
 
       it "has a reader for file_path" do
-        ExampleGroup.describe(Object) { }.file_path.should == __FILE__
+        ExampleGroup.describe(Object) { }.file_path.should eq(__FILE__)
       end
 
       it "adds the line_number to metadata" do
-        ExampleGroup.describe(Object) { }.metadata[:example_group][:line_number].should == __LINE__
+        ExampleGroup.describe(Object) { }.metadata[:example_group][:line_number].should eq(__LINE__)
       end
     end
 
@@ -454,7 +454,7 @@ module RSpec::Core
 
         group.run
 
-        order.should == [
+        order.should eq([
           :before_all_defined_in_config,
           :top_level_before_all,
           :before_each,
@@ -470,7 +470,7 @@ module RSpec::Core
           :nested_after_all,
           :top_level_after_all,
           :after_all_defined_in_config
-        ]
+        ])
       end
 
       context "after(:all)" do
@@ -509,22 +509,22 @@ module RSpec::Core
       it "treats an error in before(:each) as a failure" do
         group = ExampleGroup.describe
         group.before(:each) { raise "error in before each" }
-        example = group.example("equality") { 1.should == 2}
-        group.run.should == false
+        example = group.example("equality") { 1.should eq(2) }
+        group.run.should be(false)
 
-        example.metadata[:execution_result][:exception].message.should == "error in before each"
+        example.metadata[:execution_result][:exception].message.should eq("error in before each")
       end
 
       it "treats an error in before(:all) as a failure" do
         group = ExampleGroup.describe
         group.before(:all) { raise "error in before all" }
-        example = group.example("equality") { 1.should == 2}
-        group.run.should == false
+        example = group.example("equality") { 1.should eq(2) }
+        group.run.should be_false
 
         example.metadata.should_not be_nil
         example.metadata[:execution_result].should_not be_nil
         example.metadata[:execution_result][:exception].should_not be_nil
-        example.metadata[:execution_result][:exception].message.should == "error in before all"
+        example.metadata[:execution_result][:exception].message.should eq("error in before all")
       end
 
       it "treats an error in before(:all) as a failure for a spec in a nested group" do
@@ -533,7 +533,7 @@ module RSpec::Core
           before(:all) { raise "error in before all" }
 
           describe "nested" do
-            example = it("equality") { 1.should == 2}
+            example = it("equality") { 1.should eq(2) }
           end
         end
         group.run
@@ -541,7 +541,7 @@ module RSpec::Core
         example.metadata.should_not be_nil
         example.metadata[:execution_result].should_not be_nil
         example.metadata[:execution_result][:exception].should_not be_nil
-        example.metadata[:execution_result][:exception].message.should == "error in before all"
+        example.metadata[:execution_result][:exception].message.should eq("error in before all")
       end
 
       context "when an error occurs in an after(:all) hook" do
@@ -552,7 +552,7 @@ module RSpec::Core
         let(:group) do
           ExampleGroup.describe do
             after(:all) { raise "error in after all" }
-            it("equality") { 1.should == 1 }
+            it("equality") { 1.should eq(1) }
           end
         end
 
@@ -561,7 +561,7 @@ module RSpec::Core
           example = group.examples.first
           example.metadata.should_not be_nil
           example.metadata[:execution_result].should_not be_nil
-          example.metadata[:execution_result][:status].should == "passed"
+          example.metadata[:execution_result][:status].should eq("passed")
         end
 
         it "rescues the error and prints it out" do
@@ -576,7 +576,7 @@ module RSpec::Core
         group.before(:all) { running_example = example }
         group.example("no-op") { }
         group.run
-        running_example.should == nil
+        running_example.should be(nil)
       end
 
       it "has access to example options within before(:each)" do
@@ -585,7 +585,7 @@ module RSpec::Core
         group.before(:each) { option = example.options[:data] }
         group.example("no-op", :data => :sample) { }
         group.run
-        option.should == :sample
+        option.should eq(:sample)
       end
 
       it "has access to example options within after(:each)" do
@@ -594,7 +594,7 @@ module RSpec::Core
         group.after(:each) { option = example.options[:data] }
         group.example("no-op", :data => :sample) { }
         group.run
-        option.should == :sample
+        option.should eq(:sample)
       end
 
       it "has no 'running example' within after(:all)" do
@@ -603,7 +603,24 @@ module RSpec::Core
         group.after(:all) { running_example = example }
         group.example("no-op") { }
         group.run
-        running_example.should == nil
+        running_example.should be(nil)
+      end
+    end
+
+    matcher :add_a_pending_example_with do |method_name|
+      match do |group|
+        group = ExampleGroup.describe
+        group.send(method_name, "is pending") { }
+        group.run
+        group.examples.first.should be_pending
+      end
+    end
+
+    %w[pending xit xspecify xexample].each do |method_name|
+      describe "##{method_name}" do
+        it "generates a pending example" do
+          ExampleGroup.describe.should add_a_pending_example_with(method_name)
+        end
       end
     end
 
@@ -612,14 +629,7 @@ module RSpec::Core
       it "allows adding an example using 'it'" do
         group = ExampleGroup.describe
         group.it("should do something") { }
-        group.examples.size.should == 1
-      end
-
-      it "allows adding a pending example using 'xit'" do
-        group = ExampleGroup.describe
-        group.xit("is pending") { }
-        group.run
-        group.examples.first.should be_pending
+        group.examples.size.should eq(1)
       end
 
       it "exposes all examples at examples" do
@@ -635,9 +645,9 @@ module RSpec::Core
         group.it("should 1") { }
         group.it("should 2") { }
         group.it("should 3") { }
-        group.examples[0].description.should == 'should 1'
-        group.examples[1].description.should == 'should 2'
-        group.examples[2].description.should == 'should 3'
+        group.examples[0].description.should eq('should 1')
+        group.examples[1].description.should eq('should 2')
+        group.examples[2].description.should eq('should 3')
       end
 
     end
@@ -650,7 +660,7 @@ module RSpec::Core
         end
 
         it "sets the description to 'A sample nested describe'" do
-          example.example_group.description.should == 'A sample nested group'
+          example.example_group.description.should eq('A sample nested group')
         end
 
         it "has top level metadata from the example_group and its ancestors" do
@@ -670,8 +680,8 @@ module RSpec::Core
 
       it "returns true if all examples pass" do
         group = ExampleGroup.describe('group') do
-          example('ex 1') { 1.should == 1 }
-          example('ex 2') { 1.should == 1 }
+          example('ex 1') { 1.should eq(1) }
+          example('ex 2') { 1.should eq(1) }
         end
         group.stub(:filtered_examples) { group.examples }
         group.run(reporter).should be_true
@@ -679,8 +689,8 @@ module RSpec::Core
 
       it "returns false if any of the examples fail" do
         group = ExampleGroup.describe('group') do
-          example('ex 1') { 1.should == 1 }
-          example('ex 2') { 1.should == 2 }
+          example('ex 1') { 1.should eq(1) }
+          example('ex 2') { 1.should eq(2) }
         end
         group.stub(:filtered_examples) { group.examples }
         group.run(reporter).should be_false
@@ -688,8 +698,8 @@ module RSpec::Core
 
       it "runs all examples, regardless of any of them failing" do
         group = ExampleGroup.describe('group') do
-          example('ex 1') { 1.should == 2 }
-          example('ex 2') { 1.should == 1 }
+          example('ex 1') { 1.should eq(2) }
+          example('ex 2') { 1.should eq(1) }
         end
         group.stub(:filtered_examples) { group.examples }
         group.filtered_examples.each do |example|
@@ -709,11 +719,11 @@ module RSpec::Core
       end
 
       it "can access a before each ivar at the same level" do
-        @before_each_top_level.should == 'before_each_top_level'
+        @before_each_top_level.should eq('before_each_top_level')
       end
 
       it "can access a before all ivar at the same level" do
-        @before_all_top_level.should == 'before_all_top_level'
+        @before_all_top_level.should eq('before_all_top_level')
       end
 
       it "can access the before all ivars in the before_all_ivars hash", :ruby => 1.8 do
@@ -726,11 +736,11 @@ module RSpec::Core
 
       describe "but now I am nested" do
         it "can access a parent example groups before each ivar at a nested level" do
-          @before_each_top_level.should == 'before_each_top_level'
+          @before_each_top_level.should eq('before_each_top_level')
         end
 
         it "can access a parent example groups before all ivar at a nested level" do
-          @before_all_top_level.should == "before_all_top_level"
+          @before_all_top_level.should eq("before_all_top_level")
         end
 
         it "changes to before all ivars from within an example do not persist outside the current describe" do
@@ -739,7 +749,7 @@ module RSpec::Core
 
         describe "accessing a before_all ivar that was changed in a parent example_group" do
           it "does not have access to the modified version" do
-            @before_all_top_level.should == 'before_all_top_level'
+            @before_all_top_level.should eq('before_all_top_level')
           end
         end
       end
@@ -749,12 +759,12 @@ module RSpec::Core
     describe "ivars are not shared across examples" do
       it "(first example)" do
         @a = 1
-        @b.should be_nil
+        defined?(@b).should be_false
       end
 
       it "(second example)" do
         @b = 2
-        @a.should be_nil
+        defined?(@a).should be_false
       end
     end
 
@@ -769,7 +779,7 @@ module RSpec::Core
           end
         end
 
-        group.top_level_description.should == "top"
+        group.top_level_description.should eq("top")
       end
     end
 
@@ -826,7 +836,7 @@ module RSpec::Core
             it "does something" do
               # pass
             end
-            describe ("nested") do
+            describe "nested" do
               it "does something else" do
                 # pass
               end
@@ -843,7 +853,7 @@ module RSpec::Core
             it "does something (wrong - fail)" do
               raise "fail"
             end
-            describe ("nested") do
+            describe "nested" do
               it "does something else" do
                 # pass
               end
@@ -860,7 +870,7 @@ module RSpec::Core
             it "does something" do
               # pass
             end
-            describe ("nested") do
+            describe "nested" do
               it "does something else (wrong -fail)" do
                 raise "fail"
               end
@@ -888,6 +898,15 @@ module RSpec::Core
         end
         group.run.should be_true
       end
+
+      it "raises a helpful error message when shared context is not found" do
+        expect do
+          ExampleGroup.describe do
+            include_context "shared stuff"
+          end
+        end.to raise_error(ArgumentError,%q|Could not find shared context "shared stuff"|)
+      end
+
     end
 
     describe "#include_examples" do
@@ -904,7 +923,124 @@ module RSpec::Core
         end
         group.examples.first.description.should eq("does something")
       end
+
+      it "raises a helpful error message when shared context is not found" do
+        expect do
+          ExampleGroup.describe do
+            include_examples "shared stuff"
+          end
+        end.to raise_error(ArgumentError,%q|Could not find shared examples "shared stuff"|)
+      end
     end
 
+    describe "#it_should_behave_like" do
+      it "creates a nested group" do
+        shared_examples_for("thing") {}
+        group = ExampleGroup.describe('fake group')
+        group.it_should_behave_like("thing")
+        group.should have(1).children
+      end
+
+      it "creates a nested group for a class" do
+        klass = Class.new
+        shared_examples_for(klass) {}
+        group = ExampleGroup.describe('fake group')
+        group.it_should_behave_like(klass)
+        group.should have(1).children
+      end
+
+      it "adds shared examples to nested group" do
+        shared_examples_for("thing") do
+          it("does something")
+        end
+        group = ExampleGroup.describe('fake group')
+        shared_group = group.it_should_behave_like("thing")
+        shared_group.should have(1).examples
+      end
+
+      it "adds shared instance methods to nested group" do
+        shared_examples_for("thing") do
+          def foo; end
+        end
+        group = ExampleGroup.describe('fake group')
+        shared_group = group.it_should_behave_like("thing")
+        shared_group.public_instance_methods.map{|m| m.to_s}.should include("foo")
+      end
+
+      it "adds shared class methods to nested group" do
+        shared_examples_for("thing") do
+          def self.foo; end
+        end
+        group = ExampleGroup.describe('fake group')
+        shared_group = group.it_should_behave_like("thing")
+        shared_group.methods.map{|m| m.to_s}.should include("foo")
+      end
+
+      context "given some parameters" do
+        it "passes the parameters to the shared example group" do
+          passed_params = {}
+
+          shared_examples_for("thing") do |param1, param2|
+            it("has access to the given parameters") do
+              passed_params[:param1] = param1
+              passed_params[:param2] = param2
+            end
+          end
+
+          group = ExampleGroup.describe("group") do
+            it_should_behave_like "thing", :value1, :value2
+          end
+          group.run
+
+          passed_params.should eq({ :param1 => :value1, :param2 => :value2 })
+        end
+
+        it "adds shared instance methods to nested group" do
+          shared_examples_for("thing") do |param1|
+            def foo; end
+          end
+          group = ExampleGroup.describe('fake group')
+          shared_group = group.it_should_behave_like("thing", :a)
+          shared_group.public_instance_methods.map{|m| m.to_s}.should include("foo")
+        end
+
+        it "evals the shared example group only once" do
+          eval_count = 0
+          shared_examples_for("thing") { |p| eval_count += 1 }
+          group = ExampleGroup.describe('fake group')
+          shared_group = group.it_should_behave_like("thing", :a)
+          eval_count.should eq(1)
+        end
+      end
+
+      context "given a block" do
+        it "evaluates the block in nested group" do
+          scopes = []
+          shared_examples_for("thing") do
+            it("gets run in the nested group") do
+              scopes << self.class
+            end
+          end
+          group = ExampleGroup.describe("group") do
+            it_should_behave_like "thing" do
+              it("gets run in the same nested group") do
+                scopes << self.class
+              end
+            end
+          end
+          group.run
+
+          scopes[0].should be(scopes[1])
+        end
+      end
+
+      it "raises a helpful error message when shared context is not found" do
+        expect do
+          ExampleGroup.describe do
+            it_should_behave_like "shared stuff"
+          end
+        end.to raise_error(ArgumentError,%q|Could not find shared examples "shared stuff"|)
+      end
+    end
   end
 end