newbamboo-evented-rspec 1.1.12

data/spec/rspec_suite.rb

@@ -0,0 +1,6 @@
+if __FILE__ == $0
+  dir = File.dirname(__FILE__)
+  Dir["#{dir}/**/*_spec.rb"].reverse.each do |file|
+    require file
+  end
+end

data/spec/ruby_forker.rb

@@ -0,0 +1,13 @@
+require 'rbconfig'
+
+module RubyForker
+  # Forks a ruby interpreter with same type as ourself.
+  # juby will fork jruby, ruby will fork ruby etc.
+  def ruby(args, stderr=nil)
+    config       = ::Config::CONFIG
+    interpreter  = File::join(config['bindir'], config['ruby_install_name']) + config['EXEEXT']
+    cmd = "#{interpreter} #{args}"
+    cmd << " 2> #{stderr}" unless stderr.nil?
+    `#{cmd}`
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,6 @@
+--colour
+--format
+profile
+--timeout
+20
+--diff

data/spec/spec/dsl/main_spec.rb

@@ -0,0 +1,88 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+module Spec
+  module DSL
+    describe Main do
+      before(:each) do
+        @main = Class.new do; include Spec::DSL::Main; end
+      end
+
+      [:describe, :context].each do |method|
+        describe "##{method}" do
+          it "should delegate to Spec::Example::ExampleGroupFactory.create_example_group" do
+            block = lambda {}
+            Spec::Example::ExampleGroupFactory.should_receive(:create_example_group).with(
+              "The ExampleGroup", hash_including(:spec_path), &block
+            )
+            @main.__send__ method, "The ExampleGroup", &block
+          end
+        end
+      end
+      
+      [:share_examples_for, :shared_examples_for].each do |method|
+        describe "##{method}" do
+          it "should create a shared ExampleGroup" do
+            block = lambda {}
+            Spec::Example::ExampleGroupFactory.should_receive(:create_shared_example_group).with(
+              "shared group", hash_including(:spec_path), &block
+            )
+            @main.__send__ method, "shared group", &block
+          end
+        end
+      end
+
+      describe "#describe; with RUBY_VERSION = 1.9" do
+        it "includes an enclosing module into the block's scope" do
+          Spec::Ruby.stub!(:version).and_return("1.9")
+
+          module Foo; module Bar; end; end
+          
+          Foo::Bar.should_receive(:included).with do |*args|
+            included_by = args.last
+            included_by.description.should == "this example group"
+          end
+          
+          module Foo
+            module Bar
+              describe("this example group") do; end
+            end
+          end
+        end
+      end
+
+    
+      describe "#share_as" do
+        def self.next_group_name
+          @group_number ||= 0
+          @group_number += 1
+          "Group#{@group_number}"
+        end
+        
+        def group_name
+          @group_name ||= self.class.next_group_name
+        end
+        
+        it "registers a shared ExampleGroup" do
+          block = lambda {}
+          Spec::Example::ExampleGroupFactory.should_receive(:create_shared_example_group).with(
+            group_name, hash_including(:spec_path), &block
+          )
+          @main.share_as group_name, &block
+        end
+      
+        it "creates a constant that points to a Module" do
+          group = @main.share_as group_name do end
+          Object.const_get(group_name).should equal(group)
+        end
+      
+        it "complains if you pass it a not-constantizable name" do
+          lambda do
+            @group = @main.share_as "Non Constant" do end
+          end.should raise_error(NameError, /The first argument to share_as must be a legal name for a constant/)
+        end
+      
+      end
+    end
+  end
+end
+  

data/spec/spec/example/example_group_class_definition_spec.rb

@@ -0,0 +1,49 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+module Spec
+  module Example
+    class ExampleGroupSubclass < ExampleGroup
+      class << self
+        attr_accessor :examples_ran
+      end
+
+      @@class_variable = :class_variable
+      CONSTANT = :constant
+
+      before(:each) do
+        @instance_variable = :instance_variable
+      end
+      
+      after(:all) do
+        self.class.examples_ran = true
+      end
+
+      def a_method
+        22
+      end
+
+      it "can access instance variables defined before(:each)" do
+        @instance_variable.should == :instance_variable
+      end
+
+      it "can access class variables" do
+        @@class_variable.should == :class_variable
+      end
+
+      it "can access constants" do
+        CONSTANT.should == :constant
+      end
+
+      it "can access methods defined in the Example Group" do
+        a_method.should == 22
+      end
+      
+    end
+
+    describe ExampleGroupSubclass do
+      it "should run" do
+        ExampleGroupSubclass.examples_ran.should be_true
+      end
+    end
+  end
+end

data/spec/spec/example/example_group_factory_spec.rb

@@ -0,0 +1,224 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+module Spec
+  module Example
+    describe ExampleGroupFactory do
+      describe "#get" do
+        attr_reader :example_group
+        before(:each) do
+          @example_group_class = Class.new(ExampleGroupDouble)
+          ExampleGroupFactory.register(:registered_type, @example_group_class)
+        end
+
+        after(:each) do
+          ExampleGroupFactory.reset
+        end
+
+        it "should return the default ExampleGroup type for nil" do
+          ExampleGroupFactory.get(nil).should == ExampleGroup
+        end
+
+        it "should return the default ExampleGroup for an unregistered non-nil value" do
+          ExampleGroupFactory.get(:does_not_exist).should == ExampleGroup
+        end
+
+        it "should return custom type if registered" do
+          ExampleGroupFactory.get(:registered_type).should == @example_group_class
+        end
+
+        it "should return the actual type when that is what is submitted" do
+          ExampleGroupFactory.get(@example_group_class).should == @example_group_class
+        end
+
+        it "should get the custom type after setting the default" do
+          @alternate_example_group_class = Class.new(ExampleGroupDouble)
+          ExampleGroupFactory.default(@alternate_example_group_class)
+          ExampleGroupFactory.get(:registered_type).should == @example_group_class
+        end
+      end
+
+      describe "#create_example_group" do
+        attr_reader :parent_example_group
+        before do
+          @parent_example_group = Class.new(ExampleGroupDouble) do
+            def initialize(*args, &block)
+              ;
+            end
+          end
+        end
+
+        it "should create a uniquely named class" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group("example_group") {}
+          example_group.name.should =~ /Spec::Example::ExampleGroup::Subclass_\d+/
+        end
+
+        it "should create a Spec::Example::Example subclass by default" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group("example_group") {}
+          example_group.superclass.should == Spec::Example::ExampleGroup
+        end
+
+        it "should raise when no description is given" do
+          lambda {
+            Spec::Example::ExampleGroupFactory.create_example_group do; end
+          }.should raise_error(ArgumentError)
+        end
+
+        it "should raise when no block is given" do
+          lambda { Spec::Example::ExampleGroupFactory.create_example_group "foo" }.should raise_error(ArgumentError)
+        end
+
+        it "should run registered ExampleGroups" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group "The ExampleGroup" do end
+          Spec::Runner.options.example_groups.should include(example_group)
+        end
+
+        it "should not run unregistered ExampleGroups" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group "The ExampleGroup" do Spec::Runner.options.remove_example_group self; end
+          Spec::Runner.options.example_groups.should_not include(example_group)
+        end
+
+        describe "with :type => :default" do
+          it "should create a Spec::Example::ExampleGroup" do
+            example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "example_group", :type => :default
+            ) {}
+            example_group.superclass.should == Spec::Example::ExampleGroup
+          end
+        end
+
+        describe "with :type => :something_other_than_default" do
+          it "should create the specified type" do
+            Spec::Example::ExampleGroupFactory.register(:something_other_than_default, parent_example_group)
+            non_default_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+              "example_group", :type => :something_other_than_default
+            ) {}
+            non_default_example_group.superclass.should == parent_example_group
+          end
+        end
+
+        it "should create a type indicated by :spec_path" do
+          Spec::Example::ExampleGroupFactory.register(:something_other_than_default, parent_example_group)
+          custom_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "example_group", :spec_path => "./spec/something_other_than_default/some_spec.rb"
+          ) {}
+          custom_example_group.superclass.should == parent_example_group
+        end
+
+        it "should create a type indicated by :spec_path (with spec_path generated by caller on windows)" do
+          Spec::Example::ExampleGroupFactory.register(:something_other_than_default, parent_example_group)
+          custom_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "example_group",
+            :spec_path => "./spec\\something_other_than_default\\some_spec.rb"
+          ) {}
+          custom_example_group.superclass.should == parent_example_group
+        end
+
+        it "should create a type indicated by spec_path for a path-like key" do
+          Spec::Example::ExampleGroupFactory.register('path/to/custom/', parent_example_group)
+          custom_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "example_group", :spec_path => "./spec/path/to/custom/some_spec.rb"
+          ) {}
+          custom_example_group.superclass.should == parent_example_group
+        end
+
+        it "should use the longest key that matches when creating a type indicated by spec_path" do
+          longer = Class.new parent_example_group
+          Spec::Example::ExampleGroupFactory.register(:longer, longer)
+          long = Class.new parent_example_group
+          Spec::Example::ExampleGroupFactory.register(:long, long)
+          custom_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "example_group", :spec_path => "./spec/longer/some_spec.rb"
+          ) {}
+          custom_example_group.superclass.should == longer
+        end
+
+        it "sets the spec_path from the caller" do
+          options = {}
+          shared_example_group = Spec::Example::ExampleGroupFactory.create_example_group("foo", options) {}
+          options[:spec_path].should =~ /#{__FILE__}:#{__LINE__ - 1}/
+        end
+
+        describe "with :shared => true" do
+          def shared_example_group
+            @shared_example_group ||= Spec::Example::ExampleGroupFactory.create_example_group(
+              "name", :spec_path => '/blah/spec/models/blah.rb', :type => :controller, :shared => true
+            ) {}
+          end
+
+          it "should create and register a Spec::Example::SharedExampleGroup" do
+            shared_example_group.should be_an_instance_of(Spec::Example::SharedExampleGroup)
+            SharedExampleGroup.should include(shared_example_group)
+          end
+        end
+
+        it "should favor the :type over the :spec_path" do
+          Spec::Example::ExampleGroupFactory.register(:something_other_than_default, parent_example_group)
+          custom_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "name", :spec_path => '/blah/spec/models/blah.rb', :type => :something_other_than_default
+          ) {}
+          custom_example_group.superclass.should == parent_example_group
+        end
+
+        it "should register ExampleGroup by default" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group("The ExampleGroup") do
+          end
+          Spec::Runner.options.example_groups.should include(example_group)
+        end
+
+        it "should enable unregistering of ExampleGroups" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group("The ExampleGroup") do
+            Spec::Runner.options.remove_example_group self
+          end
+          Spec::Runner.options.example_groups.should_not include(example_group)
+        end
+
+        after(:each) do
+          Spec::Example::ExampleGroupFactory.reset
+        end
+      end
+
+      describe "#create_shared_example_group" do
+        it "registers a new shared example group" do
+          shared_example_group = Spec::Example::ExampleGroupFactory.create_shared_example_group("something shared") {}
+          shared_example_group.should be_an_instance_of(Spec::Example::SharedExampleGroup)
+          SharedExampleGroup.should include(shared_example_group)
+        end
+
+        it "sets the spec_path from the caller" do
+          options = {}
+          shared_example_group = Spec::Example::ExampleGroupFactory.create_shared_example_group("foo", options) {}
+          options[:spec_path].should =~ /#{__FILE__}:#{__LINE__ - 1}/
+        end
+      end
+
+      describe "#registered_or_ancestor_of_registered?" do
+        before(:each) do
+          @unregistered_parent = Class.new(ExampleGroupDouble)
+          @registered_child = Class.new(@unregistered_parent)
+          @unregistered_grandchild = Class.new(@registered_child)
+          Spec::Example::ExampleGroupFactory.register :registered_child, @registered_child
+        end
+
+        it "should return true for empty list" do
+          Spec::Example::ExampleGroupFactory.registered_or_ancestor_of_registered?([]).should be_true
+        end
+
+        it "should return true for a registered example group class" do
+          Spec::Example::ExampleGroupFactory.registered_or_ancestor_of_registered?([@registered_child]).should be_true
+        end
+
+        it "should return true for an ancestor of a registered example_group_classes" do
+          Spec::Example::ExampleGroupFactory.registered_or_ancestor_of_registered?([@unregistered_parent]).should be_true
+        end
+
+        it "should return false for a subclass of a registered example_group_class" do
+          Spec::Example::ExampleGroupFactory.registered_or_ancestor_of_registered?([@unregistered_grandchild]).should be_false
+        end
+
+        after(:each) do
+          Spec::Example::ExampleGroupFactory.reset
+        end
+      end
+    end
+  end
+end

data/spec/spec/example/example_group_methods_spec.rb

@@ -0,0 +1,653 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+module Spec
+  module Example
+    describe 'ExampleGroupMethods' do
+      with_sandboxed_options do
+        attr_reader :example_group, :result, :reporter
+        before(:each) do
+          # See http://rspec.lighthouseapp.com/projects/5645-rspec/tickets/525-arity-changed-on-partial-mocks#ticket-525-2
+          method_with_three_args = lambda { |arg1, arg2, arg3| }
+          options.formatters << mock("formatter", :null_object => true, :example_pending => method_with_three_args)
+          options.backtrace_tweaker = mock("backtrace_tweaker", :null_object => true)
+          @reporter = FakeReporter.new(@options)
+          options.reporter = reporter
+          @example_group = Class.new(ExampleGroupDouble) do
+            describe("ExampleGroup")
+            it "does nothing"
+          end
+        end
+        
+        after(:each) do
+          ExampleGroup.reset
+        end
+
+        ["describe","context"].each do |method|
+          describe "##{method}" do
+            describe "when creating an ExampleGroup" do
+              before(:each) do
+                @parent_example_group = Class.new(ExampleGroupDouble) do
+                  example "first example" do; end
+                end
+                @child_example_group = @parent_example_group.__send__ method, "Child" do
+                  example "second example" do; end
+                end
+              end
+
+              it "should create a subclass of the ExampleGroup when passed a block" do
+                @child_example_group.superclass.should == @parent_example_group
+                options.example_groups.should include(@child_example_group)
+              end
+
+              it "should not inherit examples" do
+                @child_example_group.should have(1).examples
+              end
+              
+              it "records the spec path" do
+                @child_example_group.spec_path.should =~ /#{__FILE__}:#{__LINE__ - 15}/
+              end
+            end
+
+            describe "when creating a SharedExampleGroup" do
+              before(:each) do
+                @shared_example_group = @example_group.__send__ method, "A Shared ExampleGroup", :shared => true do; end
+              end
+
+              after(:each) do
+                SharedExampleGroup.instance_eval{@shared_example_groups}.delete @shared_example_group
+              end
+
+              it "should create a SharedExampleGroup" do
+                @shared_example_group.should_not be_nil
+                SharedExampleGroup.find("A Shared ExampleGroup").should == @shared_example_group
+              end
+            end
+
+          end
+        end
+        
+        [:specify, :it].each do |method|
+          describe "##{method.to_s}" do
+            it "should should create an example" do
+              lambda {
+                @example_group.__send__(method, "")
+              }.should change { @example_group.examples.length }.by(1)
+            end
+          end
+        end
+        
+        [:xit, :xspecify].each do |method|
+          describe "##{method.to_s}" do
+            before(:each) do
+              Kernel.stub!(:warn)
+            end
+
+            it "should NOT create an example" do
+              lambda {
+                @example_group.__send__(method,"")
+              }.should_not change(@example_group.examples, :length)
+            end
+
+            it "should warn that the example is disabled" do
+              Kernel.should_receive(:warn).with("Example disabled: foo")
+              @example_group.__send__(method,"foo")
+            end
+          end
+        end
+        
+
+        describe "#examples" do
+          it "should have Examples" do
+            example_group = Class.new(ExampleGroupDouble) do
+              it "should exist" do; end
+            end
+            example_group.examples.length.should == 1
+            example_group.examples.first.description.should == "should exist"
+          end
+
+          it "should not include methods that begin with test (only when TU interop is loaded)" do
+            example_group = Class.new(ExampleGroupDouble) do
+              def test_any_args(*args)
+                true.should be_true
+              end
+              def test_something
+                1.should == 1
+              end
+              def test
+                raise "This is not a real test"
+              end
+              def testify
+                raise "This is not a real test"
+              end
+              def should_something
+                # forces the run
+              end
+            end
+            example_group.examples.length.should == 1
+            example_group.run(options).should be_true
+          end
+
+          it "should include methods that begin with should and has an arity of 0 in suite" do
+            example_group = Class.new(ExampleGroupDouble) do
+              def shouldCamelCase
+                true.should be_true
+              end
+              def should_any_args(*args)
+                true.should be_true
+              end
+              def should_something
+                1.should == 1
+              end
+              def should_not_something
+                1.should_not == 2
+              end
+              def should
+                raise "This is not a real example"
+              end
+              def should_not
+                raise "This is not a real example"
+              end
+            end
+            example_group.should have(4).examples
+            descriptions = example_group.examples.collect {|example| example.description.to_s}
+            descriptions.should include(
+              "shouldCamelCase",
+              "should_any_args",
+              "should_something",
+              "should_not_something")
+            descriptions.should_not include(
+              "should",
+              "should_not"
+            )
+          end
+
+          it "should not include methods that begin with test_ and has an arity > 0 in suite" do
+            example_group = Class.new(ExampleGroupDouble) do
+              def test_invalid(foo)
+                1.should == 1
+              end
+              def testInvalidCamelCase(foo)
+                1.should == 1
+              end
+            end
+            example_group.should have(:no).examples
+          end
+
+          it "should not include methods that begin with should_ and has an arity > 0 in suite" do
+            example_group = Class.new(ExampleGroupDouble) do
+              def should_invalid(foo)
+                1.should == 2
+              end
+              def shouldInvalidCamelCase(foo)
+                1.should == 3
+              end
+              def should_not_invalid(foo)
+                1.should == 4
+              end
+              def should_valid
+                1.should == 1
+              end
+            end
+            example_group.should have(1).examples
+            example_group.run(options).should be_true
+          end
+
+          it "should run should_methods" do
+            example_group = Class.new(ExampleGroupDouble) do
+              def should_valid
+                1.should == 2
+              end
+            end
+            example_group.should have(1).examples
+            example_group.run(options).should be_false
+          end
+        end
+
+        describe "#set_description" do
+          attr_reader :example_group
+          before do
+            class << example_group
+              public :set_description
+            end
+          end
+
+          describe "given a String" do
+            before(:each) do
+              example_group.set_description("abc")
+            end
+
+            specify ".description should return the String passed into .set_description" do
+              example_group.description.should == "abc"
+            end
+
+            specify ".described_type should provide nil as its type" do
+              example_group.described_type.should be_nil
+            end
+          end
+
+          describe "given a Class" do
+            before(:each) do
+              example_group.set_description(ExampleGroup)
+            end
+
+            specify ".description should return a String representation of that type (fully qualified) as its name" do
+              example_group.description.should == "Spec::Example::ExampleGroup"
+            end
+
+            specify ".described_type should return the passed in type" do
+              example_group.described_type.should == Spec::Example::ExampleGroup
+            end
+          end
+
+          describe "given a String and a Class" do
+            before(:each) do
+              example_group.set_description("behaving", ExampleGroup)
+            end
+
+            specify ".description should return String then space then Type" do
+              example_group.description.should == "behaving Spec::Example::ExampleGroup"
+            end
+
+            specify ".described_type should return the passed in type" do
+              example_group.described_type.should == Spec::Example::ExampleGroup
+            end
+          end
+
+          describe "given a Class and a String (starting with an alpha char)" do
+            before(:each) do
+              example_group.set_description(ExampleGroup, "behaving")
+            end
+
+            specify ".description should return the Type then space then String" do
+              example_group.description.should == "Spec::Example::ExampleGroup behaving"
+            end
+          end
+
+          describe "given a Class and a String (starting with a '.')" do
+            before(:each) do
+              example_group.set_description(ExampleGroup, ".behaving")
+            end
+
+            specify ".description should return the Type then String" do
+              example_group.description.should == "Spec::Example::ExampleGroup.behaving"
+            end
+          end
+
+          describe "#set_description(Class, String starting with #)" do
+            before(:each) do
+              example_group.set_description(ExampleGroup, "#behaving")
+            end
+
+            specify "should return the Class then String" do
+              example_group.description.should == "Spec::Example::ExampleGroup#behaving"
+            end
+          end
+
+          describe "#set_description(Class, String containing .)" do
+            before(:each) do
+              example_group.set_description(ExampleGroup, "calling a.b")
+            end
+
+            specify ".description should return the Type then space then String" do
+              example_group.description.should == "Spec::Example::ExampleGroup calling a.b"
+            end
+          end
+
+          describe "#set_description(Class, String containing #)" do
+            before(:each) do
+              example_group.set_description(ExampleGroup, "is #1")
+            end
+
+            specify ".description should return the Type then space then String" do
+              example_group.description.should == "Spec::Example::ExampleGroup is #1"
+            end
+          end
+
+          describe "#set_description(String, Type, String)" do
+            before(:each) do
+              example_group.set_description("A", Hash, "with one entry")
+            end
+
+            specify ".description should return the first String then space then Type then second String" do
+              example_group.description.should == "A Hash with one entry"
+            end
+          end
+
+          describe "#set_description(Hash representing options)" do
+            before(:each) do
+              example_group.set_description(:a => "b", :spec_path => "blah")
+            end
+
+            it ".spec_path should expand the passed in :spec_path option passed into the constructor" do
+              example_group.spec_path.should == File.expand_path("blah")
+            end
+
+            it ".description_options should return all the options passed in" do
+              example_group.description_options.should == {:a => "b", :spec_path => "blah"}
+            end
+
+          end
+        end
+
+        describe "#description" do
+          it "should return the same description instance for each call" do
+            example_group.description.should eql(example_group.description)
+          end
+
+          it "should not add a space when description_text begins with #" do
+            child_example_group = Class.new(example_group) do
+              describe("#foobar", "Does something")
+            end
+            child_example_group.description.should == "ExampleGroup#foobar Does something"
+          end
+
+          it "should not add a space when description_text begins with ." do
+            child_example_group = Class.new(example_group) do
+              describe(".foobar", "Does something")
+            end
+            child_example_group.description.should == "ExampleGroup.foobar Does something"
+          end
+        
+          it "should return the class name if nil" do
+            example_group.set_description(nil)
+            example_group.description.should =~ /Class:/
+          end
+        
+          it "should return the class name if nil" do
+            example_group.set_description("")
+            example_group.description.should =~ /Class:/
+          end
+          
+          it "is cached" do
+            example_group.set_description("describe me")
+            example_group.description.should be(example_group.description)
+          end
+        end
+
+        describe "#description_parts" do
+          it "should return an Array of the current class description args" do
+            example_group.description_parts.should == [example_group.description]
+          end
+
+          it "should return an Array of the description args from each class in the hierarchy" do
+            parent_example_group = Class.new(ExampleGroupDouble) do
+              describe("Parent")
+            end
+            
+            child_example_group = Class.new(parent_example_group)
+            child_example_group.describe("Child", ExampleGroup)
+            child_example_group.description.should_not be_empty
+
+            grand_child_example_group = Class.new(child_example_group)
+            grand_child_example_group.describe("GrandChild", ExampleGroup)
+            grand_child_example_group.description.should_not be_empty
+
+            grand_child_example_group.description_parts.should == [
+              "Parent",
+              "Child",
+              Spec::Example::ExampleGroup,
+              "GrandChild",
+              Spec::Example::ExampleGroup
+            ]
+          end
+          
+          it "caches the description parts" do
+            example_group.description_parts.should equal(example_group.description_parts)
+          end
+        end
+
+        describe "#described_type" do
+          it "should return passed in type" do
+            child_example_group = Class.new(example_group) do
+              describe Object
+            end
+            child_example_group.described_type.should == Object
+          end
+
+          it "should return #described_type of superclass when no passed in type" do
+            parent_example_group = Class.new(ExampleGroupDouble) do
+              describe Object, "#foobar"
+            end
+            child_example_group = Class.new(parent_example_group) do
+              describe "not a type"
+            end
+            child_example_group.described_type.should == Object
+          end
+          
+          it "is cached per example group" do
+            klass = Class.new
+            group = Class.new(ExampleGroupDouble) do
+              describe(klass)
+            end
+            group.should_receive(:description_parts).once.and_return([klass])
+            group.described_type
+            group.described_type
+          end
+        end
+
+        describe "#remove_after" do
+          it "should unregister a given after(:each) block" do
+            after_all_ran = false
+            proc = Proc.new { after_all_ran = true }
+
+            example_group = Class.new(ExampleGroupDouble) do
+              specify("example") {}
+              after(:each, &proc)
+            end
+
+            example_group.run(options)
+            after_all_ran.should be_true
+
+            after_all_ran = false
+            example_group.remove_after(:each, &proc)
+            example_group.run(options)
+            after_all_ran.should be_false
+          end
+        end
+
+        describe "#include" do
+          it "should have accessible class methods from included module" do
+            mod_method_called = false
+            mod = Module.new do
+              class_methods = Module.new do
+                define_method :mod_method do
+                  mod_method_called = true
+                end
+              end
+
+              self.class.class_eval do
+                define_method(:included) do |receiver|
+                  receiver.extend class_methods
+                end
+              end
+            end
+
+            @example_group.__send__ :include, mod
+
+            @example_group.mod_method
+            mod_method_called.should be_true
+          end
+        end
+
+        describe "#number_of_examples" do
+          it "should count number of examples" do
+            proc do
+              @example_group.it("one") {}
+              @example_group.it("two") {}
+              @example_group.it("three") {}
+              @example_group.it("four") {}
+            end.should change {@example_group.number_of_examples}.by(4)
+          end
+        end
+
+        describe "#class_eval" do
+          it "should allow constants to be defined" do
+            example_group = Class.new(ExampleGroupDouble) do
+              FOO = 1
+              it "should reference FOO" do
+                FOO.should == 1
+              end
+            end
+            success = example_group.run(options)
+            success.should be_true
+            Object.const_defined?(:FOO).should == false
+          end
+        end
+
+        describe '#register' do
+          after(:each) do
+            Spec::Runner.options.remove_example_group example_group
+          end
+          it "should add ExampleGroup to set of ExampleGroups to be run" do
+            Spec::Runner.options.add_example_group example_group
+            options.example_groups.should include(example_group)
+          end
+        end
+
+        describe '#remove_example_group' do
+          before(:each) do
+            Spec::Runner.options.add_example_group example_group
+          end
+          it "should remove ExampleGroup from set of ExampleGroups to be run" do
+            Spec::Runner.options.remove_example_group example_group
+            options.example_groups.should_not include(example_group)
+          end
+        end
+      
+        describe "#run" do
+          describe "given an example group with at least one example" do
+            it "should call add_example_group" do
+              example_group = Class.new(ExampleGroupDouble) do
+                example("anything") {}
+              end
+              reporter.should_receive(:add_example_group)
+              example_group.run(options)
+            end
+          end
+
+          describe "given an example group with no examples" do
+            it "should NOT call add_example_group" do
+              example_group = Class.new(ExampleGroupDouble) do end
+              reporter.should_not_receive(:add_example_group)
+              example_group.run(options)
+            end
+          end
+        end
+
+        describe "#matcher_class=" do 
+          it "should call new and matches? on the class used for matching examples" do 
+            example_group = Class.new(ExampleGroupDouble) do
+              it "should do something" do end
+              def self.specified_examples
+                ["something"]
+              end
+              def self.to_s
+                "TestMatcher"
+              end
+            end
+
+            matcher = mock("matcher")
+            matcher.should_receive(:matches?).with(["something"]).any_number_of_times
+          
+            matcher_class = Class.new
+            matcher_class.should_receive(:new).with("TestMatcher", "should do something").and_return(matcher)
+
+            begin 
+              ExampleGroupMethods.matcher_class = matcher_class
+
+              example_group.run(options)
+            ensure 
+              ExampleGroupMethods.matcher_class = ExampleMatcher
+            end
+          end
+        end
+
+        describe "#options" do
+          it "should expose the options hash" do
+            group = describe("group", :this => 'hash') {}
+            group.options[:this].should == 'hash'
+          end
+        end
+
+        describe "#backtrace" do        
+          it "returns the backtrace from where the example group was defined" do
+            example_group = Class.new(ExampleGroupDouble).describe("foo") do
+              example "bar" do; end
+            end
+            example_group.backtrace.join("\n").should include("#{__FILE__}:#{__LINE__-3}")
+          end
+        end
+
+        describe "#example_group_backtrace (deprecated)" do        
+          before(:each) do
+            Kernel.stub!(:warn)
+          end
+          it "sends a deprecation warning" do
+            example_group = Class.new(ExampleGroupDouble) {}
+            Kernel.should_receive(:warn).with(/#example_group_backtrace.*deprecated.*#backtrace instead/m)
+            example_group.example_group_backtrace
+          end
+
+          it "returns the backtrace from where the example group was defined" do
+            example_group = Class.new(ExampleGroupDouble).describe("foo") do
+              example "bar" do; end
+            end
+            example_group.example_group_backtrace.join("\n").should include("#{__FILE__}:#{__LINE__-3}")
+          end
+        end
+        
+        describe "#before" do
+          it "stores before(:each) blocks" do
+            example_group = Class.new(ExampleGroupDouble) {}
+            block = lambda {}
+            example_group.before(:each, &block)
+            example_group.before_each_parts.should include(block)
+          end
+
+          it "stores before(:all) blocks" do
+            example_group = Class.new(ExampleGroupDouble) {}
+            block = lambda {}
+            example_group.before(:all, &block)
+            example_group.before_all_parts.should include(block)
+          end
+
+          it "stores before(:suite) blocks" do
+            example_group = Class.new(ExampleGroupDouble) {}
+            parts = []
+            ExampleGroupMethods.stub!(:before_suite_parts).and_return(parts)
+            block = lambda {}
+            example_group.before(:suite, &block)
+            example_group.before_suite_parts.should include(block)
+          end
+        end
+
+        
+        describe "#after" do
+          it "stores after(:each) blocks" do
+            example_group = Class.new(ExampleGroupDouble) {}
+            block = lambda {}
+            example_group.after(:each, &block)
+            example_group.after_each_parts.should include(block)
+          end
+
+          it "stores after(:all) blocks" do
+            example_group = Class.new(ExampleGroupDouble) {}
+            block = lambda {}
+            example_group.after(:all, &block)
+            example_group.after_all_parts.should include(block)
+          end
+
+          it "stores after(:suite) blocks" do
+            example_group = Class.new(ExampleGroupDouble) {}
+            parts = []
+            ExampleGroupMethods.stub!(:after_suite_parts).and_return(parts)
+            block = lambda {}
+            example_group.after(:suite, &block)
+            example_group.after_suite_parts.should include(block)
+          end
+        end
+
+      end
+    end
+  end
+end