mspec 1.3.1 → 1.4.0

data/lib/mspec/runner/mspec.rb

@@ -18,18 +18,21 @@ module MSpec
   @mode    = nil
   @load    = nil
   @unload  = nil
+  @current = nil
+  @shared  = {}
   @exception    = nil
   @randomize    = nil
   @expectation  = nil
   @expectations = false
 
-  def self.describe(mod, msg=nil, &block)
-    stack.push ContextState.new
+  def self.describe(mod, options=nil, &block)
+    state = ContextState.new mod, options
+    state.parent = current
 
-    current.describe(mod, msg, &block)
-    current.process
+    MSpec.register_current state
+    state.describe(&block)
 
-    stack.pop
+    state.process unless state.shared? or current
   end
 
   def self.process
@@ -62,6 +65,8 @@ module MSpec
     begin
       @env.instance_eval(&block)
       return true
+    rescue SystemExit
+      raise
     rescue Exception => exc
       register_exit 1
       actions :exception, ExceptionState.new(current && current.state, location, exc)
@@ -69,14 +74,42 @@ module MSpec
     end
   end
 
+  # Sets the toplevel ContextState to +state+.
+  def self.register_current(state)
+    store :current, state
+  end
+
+  # Sets the toplevel ContextState to +nil+.
+  def self.clear_current
+    store :current, nil
+  end
+
+  # Returns the toplevel ContextState.
+  def self.current
+    retrieve :current
+  end
+
+  # Stores the shared ContextState keyed by description.
+  def self.register_shared(state)
+    @shared[state.to_s] = state
+  end
+
+  # Returns the shared ContextState matching description.
+  def self.retrieve_shared(desc)
+    @shared[desc.to_s]
+  end
+
+  # Stores the exit code used by the runner scripts.
   def self.register_exit(code)
     store :exit, code
   end
 
+  # Retrieves the stored exit code.
   def self.exit_code
     retrieve(:exit).to_i
   end
 
+  # Stores the list of files to be evaluated.
   def self.register_files(files)
     store :files, files
   end
@@ -141,14 +174,6 @@ module MSpec
     end
   end
 
-  def self.stack
-    @stack ||= []
-  end
-
-  def self.current
-    stack.last
-  end
-
   def self.verify_mode?
     @mode == :verify
   end

data/lib/mspec/runner/object.rb

@@ -7,7 +7,7 @@ class Object
     MSpec.current.after at, &block
   end
 
-  def describe(mod, msg=nil, &block)
+  def describe(mod, msg=nil, options=nil, &block)
     MSpec.describe mod, msg, &block
   end
 
@@ -15,6 +15,10 @@ class Object
     MSpec.current.it msg, &block
   end
 
+  def it_should_behave_like(desc)
+    MSpec.current.it_should_behave_like desc
+  end
+
   alias_method :context, :describe
   alias_method :specify, :it
 end

data/lib/mspec/runner/shared.rb

@@ -1,12 +1,12 @@
 require 'mspec/runner/mspec'
 
 class Object
-  def shared(msg, &block)
-    MSpec.store msg.to_sym, block
-  end
+  def it_behaves_like(desc, meth, obj=nil)
+    send :before, :all do
+      @method = meth
+      @object = obj if obj
+    end
 
-  def it_behaves_like(behavior, *args)
-    p = MSpec.retrieve behavior.to_sym
-    p[*args]
+    send :it_should_behave_like, desc.to_s
   end
 end

data/lib/mspec/version.rb

@@ -1,3 +1,3 @@
 module MSpec
-  VERSION = '1.3.1'
+  VERSION = '1.4.0'
 end

data/spec/commands/mspec_ci_spec.rb

@@ -121,6 +121,20 @@ describe MSpecCI, "#run" do
     @script.run
   end
 
+  it "registers a tag filter for 'critical'" do
+    filter = mock("critical filter")
+    TagFilter.should_receive(:new).with(:exclude, 'critical').and_return(filter)
+    filter.should_receive(:register)
+    @script.run
+  end
+
+  it "registers a tag filter for 'unsupported'" do
+    filter = mock("unsupported filter")
+    TagFilter.should_receive(:new).with(:exclude, 'unsupported').and_return(filter)
+    filter.should_receive(:register)
+    @script.run
+  end
+
   it "processes the files" do
     MSpec.should_receive(:process)
     @script.run

data/spec/matchers/equal_element_spec.rb

@@ -0,0 +1,75 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+require 'mspec/expectations/expectations'
+require 'mspec/matchers/equal_element'
+
+describe EqualElementMatcher do
+  it "matches if it finds an element with the passed name, no matter what attributes/content" do
+    EqualElementMatcher.new("A").matches?('<A></A>').should be_true
+    EqualElementMatcher.new("A").matches?('<A HREF="http://example.com"></A>').should be_true
+    EqualElementMatcher.new("A").matches?('<A HREF="http://example.com"></A>').should be_true
+
+    EqualElementMatcher.new("BASE").matches?('<BASE></A>').should be_false
+    EqualElementMatcher.new("BASE").matches?('<A></BASE>').should be_false
+    EqualElementMatcher.new("BASE").matches?('<A></A>').should be_false
+    EqualElementMatcher.new("BASE").matches?('<A HREF="http://example.com"></A>').should be_false
+    EqualElementMatcher.new("BASE").matches?('<A HREF="http://example.com"></A>').should be_false
+  end
+
+  it "matches if it finds an element with the passed name and the passed attributes" do
+    EqualElementMatcher.new("A", {}).matches?('<A></A>').should be_true
+    EqualElementMatcher.new("A", nil).matches?('<A HREF="http://example.com"></A>').should be_true
+    EqualElementMatcher.new("A", "HREF" => "http://example.com").matches?('<A HREF="http://example.com"></A>').should be_true
+
+    EqualElementMatcher.new("A", {}).matches?('<A HREF="http://example.com"></A>').should be_false
+    EqualElementMatcher.new("A", "HREF" => "http://example.com").matches?('<A></A>').should be_false
+    EqualElementMatcher.new("A", "HREF" => "http://example.com").matches?('<A HREF="http://test.com"></A>').should be_false
+    EqualElementMatcher.new("A", "HREF" => "http://example.com").matches?('<A HREF="http://example.com" HREF="http://example.com"></A>').should be_false
+  end
+
+  it "matches if it finds an element with the passed name, the passed attributes and the passed content" do
+    EqualElementMatcher.new("A", {}, "").matches?('<A></A>').should be_true
+    EqualElementMatcher.new("A", {"HREF" => "http://example.com"}, "Example").matches?('<A HREF="http://example.com">Example</A>').should be_true
+
+    EqualElementMatcher.new("A", {}, "Test").matches?('<A></A>').should be_false
+    EqualElementMatcher.new("A", {"HREF" => "http://example.com"}, "Example").matches?('<A HREF="http://example.com"></A>').should be_false
+    EqualElementMatcher.new("A", {"HREF" => "http://example.com"}, "Example").matches?('<A HREF="http://example.com">Test</A>').should be_false
+  end
+  
+  it "can match unclosed elements" do
+    EqualElementMatcher.new("BASE", nil, nil, :not_closed => true).matches?('<BASE>').should be_true
+    EqualElementMatcher.new("BASE", {"HREF" => "http://example.com"}, nil, :not_closed => true).matches?('<BASE HREF="http://example.com">').should be_true
+    EqualElementMatcher.new("BASE", {"HREF" => "http://example.com"}, "Example", :not_closed => true).matches?('<BASE HREF="http://example.com">Example').should be_true
+
+    EqualElementMatcher.new("BASE", {}, nil, :not_closed => true).matches?('<BASE HREF="http://example.com">').should be_false
+    EqualElementMatcher.new("BASE", {"HREF" => "http://example.com"}, "", :not_closed => true).matches?('<BASE HREF="http://example.com">Example').should be_false
+    EqualElementMatcher.new("BASE", {"HREF" => "http://example.com"}, "Test", :not_closed => true).matches?('<BASE HREF="http://example.com">Example').should be_false
+  end
+
+  it "provides a useful failure message" do
+    equal_element = EqualElementMatcher.new("A", {}, "Test")
+    equal_element.matches?('<A></A>').should be_false
+    equal_element.failure_message.should == [%{Expected "<A></A>"\n}, %{to be a 'A' element with no attributes and "Test" as content}]
+
+    equal_element = EqualElementMatcher.new("A", {}, "")
+    equal_element.matches?('<A>Test</A>').should be_false
+    equal_element.failure_message.should == [%{Expected "<A>Test</A>"\n}, %{to be a 'A' element with no attributes and no content}]
+
+    equal_element = EqualElementMatcher.new("A", "HREF" => "http://www.example.com")
+    equal_element.matches?('<A>Test</A>').should be_false
+    equal_element.failure_message.should == [%{Expected "<A>Test</A>"\n}, %{to be a 'A' element with HREF="http://www.example.com" and any content}]
+  end
+
+  it "provides a useful negative failure message" do
+    equal_element = EqualElementMatcher.new("A", {}, "Test")
+    equal_element.matches?('<A></A>').should be_false
+    equal_element.negative_failure_message.should == [%{Expected "<A></A>"\n}, %{not to be a 'A' element with no attributes and "Test" as content}]
+
+    equal_element = EqualElementMatcher.new("A", {}, "")
+    equal_element.matches?('<A>Test</A>').should be_false
+    equal_element.negative_failure_message.should == [%{Expected "<A>Test</A>"\n}, %{not to be a 'A' element with no attributes and no content}]
+
+    equal_element = EqualElementMatcher.new("A", "HREF" => "http://www.example.com")
+    equal_element.matches?('<A>Test</A>').should be_false
+    equal_element.negative_failure_message.should == [%{Expected "<A>Test</A>"\n}, %{not to be a 'A' element with HREF="http://www.example.com" and any content}]
+  end
+end

data/spec/runner/actions/debug_spec.rb

@@ -1,6 +1,7 @@
 require File.dirname(__FILE__) + '/../../spec_helper'
 require 'mspec/runner/actions/debug'
 require 'mspec/runner/mspec'
+require 'mspec/runner/context'
 require 'mspec/runner/example'
 
 describe DebugAction do
@@ -18,7 +19,7 @@ end
 describe DebugAction, "#before" do
   before :each do
     MSpec.stub!(:read_tags).and_return([])
-    @state = ExampleState.new "Catch#me", "if you can"
+    @state = ExampleState.new ContextState.new("Catch#me"), "if you can"
   end
 
   it "does not invoke the debugger if the description does not match" do

data/spec/runner/actions/gdb_spec.rb

@@ -18,7 +18,7 @@ end
 describe GdbAction, "#before" do
   before :each do
     MSpec.stub!(:read_tags).and_return([])
-    @state = ExampleState.new "Catch#me", "if you can"
+    @state = ExampleState.new ContextState.new("Catch#me"), "if you can"
   end
 
   it "does not invoke the debugger if the description does not match" do

data/spec/runner/actions/tag_spec.rb

@@ -94,7 +94,7 @@ describe TagAction, "#before" do
     action.exception?.should be_false
     action.exception ExceptionState.new(nil, nil, Exception.new("Fail!"))
     action.exception?.should be_true
-    action.before(ExampleState.new("describe", "it"))
+    action.before(ExampleState.new(ContextState.new("describe"), "it"))
     action.exception?.should be_false
   end
 end
@@ -111,7 +111,8 @@ end
 describe TagAction, "#after when action is :add" do
   before :each do
     MSpec.stub!(:read_tags).and_return([])
-    @state = ExampleState.new "Catch#me", "if you can"
+    context = ContextState.new "Catch#me"
+    @state = ExampleState.new context, "if you can"
     @tag = SpecTag.new "tag(comment):Catch#me if you can"
     SpecTag.stub!(:new).and_return(@tag)
     @exception = ExceptionState.new nil, nil, Exception.new("failed")
@@ -159,7 +160,8 @@ end
 describe TagAction, "#after when action is :del" do
   before :each do
     MSpec.stub!(:read_tags).and_return([])
-    @state = ExampleState.new "Catch#me", "if you can"
+    context = ContextState.new "Catch#me"
+    @state = ExampleState.new context, "if you can"
     @tag = SpecTag.new "tag(comment):Catch#me if you can"
     SpecTag.stub!(:new).and_return(@tag)
     @exception = ExceptionState.new nil, nil, Exception.new("failed")
@@ -207,7 +209,8 @@ end
 describe TagAction, "#finish" do
   before :each do
     $stdout = @out = IOStub.new
-    @state = ExampleState.new "Catch#me", "if you can"
+    context = ContextState.new "Catch#me"
+    @state = ExampleState.new context, "if you can"
     MSpec.stub!(:write_tag).and_return(true)
     MSpec.stub!(:delete_tag).and_return(true)
   end

data/spec/runner/context_spec.rb

@@ -5,43 +5,198 @@ require 'mspec/runner/mspec'
 require 'mspec/mocks/mock'
 require 'mspec/runner/context'
 
-describe ContextState do
+describe ContextState, "#describe" do
   before :each do
-    @state = ContextState.new
+    @state = ContextState.new "C#m"
+    @proc = lambda { ScratchPad.record :a }
+    ScratchPad.clear
+  end
+
+  it "evaluates the passed block" do
+    @state.describe(&@proc)
+    ScratchPad.recorded.should == :a
+  end
+
+  it "evaluates the passed block via #protect" do
+    @state.should_receive(:protect).with("C#m", @proc, false)
+    @state.describe(&@proc)
+  end
+
+  it "registers #parent as the current MSpec ContextState" do
+    parent = ContextState.new ""
+    @state.parent = parent
+    MSpec.should_receive(:register_current).with(parent)
+    @state.describe { }
+  end
+
+  it "registers self with MSpec when #shared? is true" do
+    state = ContextState.new "something shared", :shared => true
+    MSpec.should_receive(:register_shared).with(state)
+    state.describe { }
+  end
+end
+
+describe ContextState, "#shared?" do
+  it "returns false when the ContextState is not shared" do
+    ContextState.new("").shared?.should be_false
+  end
+
+  it "returns true when the ContextState is shared" do
+    ContextState.new("", {:shared => true}).shared?.should be_true
+  end
+end
+
+describe ContextState, "#to_s" do
+  it "returns a description string for self when passed a Module" do
+    ContextState.new(Object).to_s.should == "Object"
+  end
+
+  it "returns a description string for self when passed a String" do
+    ContextState.new("SomeClass").to_s.should == "SomeClass"
+  end
+
+  it "returns a description string for self when passed a Module, String" do
+    ContextState.new(Object, "when empty").to_s.should == "Object when empty"
+  end
+
+  it "returns a description string for self when passed a Module and String beginning with '#'" do
+    ContextState.new(Object, "#to_s").to_s.should == "Object#to_s"
+  end
+
+  it "returns a description string for self when passed a Module and String beginning with '.'" do
+    ContextState.new(Object, ".to_s").to_s.should == "Object.to_s"
+  end
+
+  it "returns a description string for self when passed a Module and String beginning with '::'" do
+    ContextState.new(Object, "::to_s").to_s.should == "Object::to_s"
+  end
+end
+
+describe ContextState, "#description" do
+  before :each do
+    @state = ContextState.new "when empty"
+    @parent = ContextState.new "Toplevel"
+  end
+
+  it "returns a composite description string from self and all parents" do
+    @parent.description.should == "Toplevel"
+    @state.description.should == "when empty"
+    @state.parent = @parent
+    @state.description.should == "Toplevel when empty"
+  end
+end
+
+describe ContextState, "#it" do
+  before :each do
+    @state = ContextState.new ""
     @proc = lambda { }
   end
 
-  it "records before(:all) blocks" do
-    @state.before(:all, &@proc)
-    @state.instance_variable_get(:@start).should == [@proc]
+  it "creates an ExampleState instance for the block" do
+    ex = ExampleState.new("", "", &@proc)
+    ExampleState.should_receive(:new).with(@state, "it", @proc).and_return(ex)
+    @state.describe(&@proc)
+    @state.it("it", &@proc)
+  end
+end
+
+describe ContextState, "#examples" do
+  before :each do
+    @state = ContextState.new ""
+  end
+
+  it "returns a list of all examples in this ContextState" do
+    @state.it("first") { }
+    @state.it("second") { }
+    @state.examples.size.should == 2
+  end
+end
+
+describe ContextState, "#before" do
+  before :each do
+    @state = ContextState.new ""
+    @proc = lambda { }
   end
 
-  it "records before(:each) blocks" do
+  it "records the block for :each" do
     @state.before(:each, &@proc)
-    @state.instance_variable_get(:@before).should == [@proc]
+    @state.before(:each).should == [@proc]
   end
 
-  it "records after(:all) blocks" do
-    @state.after(:all, &@proc)
-    @state.instance_variable_get(:@finish).should == [@proc]
+  it "records the block for :all" do
+    @state.before(:all, &@proc)
+    @state.before(:all).should == [@proc]
+  end
+end
+
+describe ContextState, "#after" do
+  before :each do
+    @state = ContextState.new ""
+    @proc = lambda { }
   end
 
-  it "records after(:each) blocks" do
+  it "records the block for :each" do
     @state.after(:each, &@proc)
-    @state.instance_variable_get(:@after).should == [@proc]
+    @state.after(:each).should == [@proc]
+  end
+
+  it "records the block for :all" do
+    @state.after(:all, &@proc)
+    @state.after(:all).should == [@proc]
+  end
+end
+
+describe ContextState, "#pre" do
+  before :each do
+    @a = lambda { }
+    @b = lambda { }
+    @c = lambda { }
+
+    parent = ContextState.new ""
+    parent.before(:each, &@c)
+    parent.before(:all, &@c)
+
+    @state = ContextState.new ""
+    @state.parent = parent
+  end
+
+  it "returns before(:each) actions in the order they were defined" do
+    @state.before(:each, &@a)
+    @state.before(:each, &@b)
+    @state.pre(:each).should == [@c, @a, @b]
+  end
+
+  it "returns before(:all) actions in the order they were defined" do
+    @state.before(:all, &@a)
+    @state.before(:all, &@b)
+    @state.pre(:all).should == [@c, @a, @b]
+  end
+end
+
+describe ContextState, "#post" do
+  before :each do
+    @a = lambda { }
+    @b = lambda { }
+    @c = lambda { }
+
+    parent = ContextState.new ""
+    parent.after(:each, &@c)
+    parent.after(:all, &@c)
+
+    @state = ContextState.new ""
+    @state.parent = parent
   end
 
-  it "records it blocks" do
-    @state.it("message", &@proc)
-    msg, proc = @state.instance_variable_get(:@spec)[0]
-    msg.should == "message"
-    proc.should == @proc
+  it "returns after(:each) actions in the reverse order they were defined" do
+    @state.after(:each, &@a)
+    @state.after(:each, &@b)
+    @state.post(:each).should == [@b, @a, @c]
   end
 
-  it "records describe blocks" do
-    @state.describe(Object, "message", &@proc)
-    @state.instance_variable_get(:@describe).should == "Object message"
-    @state.instance_variable_get(:@block).should == @proc
+  it "returns after(:all) actions in the reverse order they were defined" do
+    @state.after(:all, &@a)
+    @state.after(:all, &@b)
+    @state.post(:all).should == [@b, @a, @c]
   end
 end
 
@@ -55,27 +210,116 @@ describe ContextState, "#protect" do
 
   it "returns true and does execute any blocks if check is true and MSpec.pretend_mode? is true" do
     MSpec.stub!(:pretend_mode?).and_return(true)
-    ContextState.new.protect("message", [@a, @b]).should be_true
+    ContextState.new("").protect("message", [@a, @b]).should be_true
     ScratchPad.recorded.should == []
   end
 
   it "executes the blocks if MSpec.pretend_mode? is false" do
     MSpec.stub!(:pretend_mode?).and_return(false)
-    ContextState.new.protect("message", [@a, @b])
+    ContextState.new("").protect("message", [@a, @b])
     ScratchPad.recorded.should == [:a, :b]
   end
 
   it "executes the blocks if check is false" do
-    ContextState.new.protect("message", [@a, @b], false)
+    ContextState.new("").protect("message", [@a, @b], false)
     ScratchPad.recorded.should == [:a, :b]
   end
 
   it "returns true if none of the blocks raise an exception" do
-    ContextState.new.protect("message", [@a, @b]).should be_true
+    ContextState.new("").protect("message", [@a, @b]).should be_true
   end
 
   it "returns false if any of the blocks raise an exception" do
-    ContextState.new.protect("message", [@a, @c, @b]).should be_false
+    ContextState.new("").protect("message", [@a, @c, @b]).should be_false
+  end
+end
+
+describe ContextState, "#parent=" do
+  before :each do
+    @state = ContextState.new ""
+    @parent = mock("describe")
+    @parent.stub!(:parent).and_return(nil)
+    @parent.stub!(:child)
+  end
+
+  it "does not set self as a child of parent if shared" do
+    @parent.should_not_receive(:child)
+    state = ContextState.new "", :shared => true
+    state.parent = @parent
+  end
+
+  it "sets self as a child of parent" do
+    @parent.should_receive(:child).with(@state)
+    @state.parent = @parent
+  end
+
+  it "creates the list of parents" do
+    @state.parent = @parent
+    @state.parents.should == [@parent, @state]
+  end
+end
+
+describe ContextState, "#parent" do
+  before :each do
+    @state = ContextState.new ""
+    @parent = mock("describe")
+    @parent.stub!(:parent).and_return(nil)
+    @parent.stub!(:child)
+  end
+
+  it "returns nil if parent has not been set" do
+    @state.parent.should be_nil
+  end
+
+  it "returns the parent" do
+    @state.parent = @parent
+    @state.parent.should == @parent
+  end
+end
+
+describe ContextState, "#parents" do
+  before :each do
+    @first = ContextState.new ""
+    @second = ContextState.new ""
+    @parent = mock("describe")
+    @parent.stub!(:parent).and_return(nil)
+    @parent.stub!(:child)
+  end
+
+  it "returns a list of all enclosing ContextState instances" do
+    @first.parent = @parent
+    @second.parent = @first
+    @second.parents.should == [@parent, @first, @second]
+  end
+end
+
+describe ContextState, "#child" do
+  before :each do
+    @first = ContextState.new ""
+    @second = ContextState.new ""
+    @parent = mock("describe")
+    @parent.stub!(:parent).and_return(nil)
+    @parent.stub!(:child)
+  end
+
+  it "adds the ContextState to the list of contained ContextStates" do
+    @first.child @second
+    @first.children.should == [@second]
+  end
+end
+
+describe ContextState, "#children" do
+  before :each do
+    @parent = ContextState.new ""
+    @first = ContextState.new ""
+    @second = ContextState.new ""
+  end
+
+  it "returns the list of directly contained ContextStates" do
+    @first.parent = @parent
+    @second.parent = @first
+    @parent.children.should == [@first]
+    @first.children.should == [@second]
   end
 end
 
@@ -84,7 +328,7 @@ describe ContextState, "#state" do
     MSpec.store :before, []
     MSpec.store :after, []
 
-    @state = ContextState.new
+    @state = ContextState.new ""
   end
 
   it "returns nil if no spec is being executed" do
@@ -93,7 +337,7 @@ describe ContextState, "#state" do
 
   it "returns a ExampleState instance if an example is being executed" do
     ScratchPad.record @state
-    @state.describe("") { }
+    @state.describe { }
     @state.it("") { ScratchPad.record ScratchPad.recorded.state }
     @state.process
     @state.state.should == nil
@@ -105,9 +349,10 @@ describe ContextState, "#process" do
   before :each do
     MSpec.store :before, []
     MSpec.store :after, []
+    MSpec.stub!(:register_current)
 
-    @state = ContextState.new
-    @state.describe("") { }
+    @state = ContextState.new ""
+    @state.describe { }
 
     @a = lambda { ScratchPad << :a }
     @b = lambda { ScratchPad << :b }
@@ -127,7 +372,7 @@ describe ContextState, "#process" do
     @state.after(:all, &@b)
     @state.it("") { }
     @state.process
-    ScratchPad.recorded.should == [:a, :b]
+    ScratchPad.recorded.should == [:b, :a]
   end
 
   it "calls each it block" do
@@ -137,6 +382,14 @@ describe ContextState, "#process" do
     ScratchPad.recorded.should == [:a, :b]
   end
 
+  it "does not call the #it block if #filtered? returns true" do
+    @state.it("one", &@a)
+    @state.it("two", &@b)
+    @state.examples.first.stub!(:filtered?).and_return(true)
+    @state.process
+    ScratchPad.recorded.should == [:b]
+  end
+
   it "calls each before(:each) block" do
     @state.before(:each, &@a)
     @state.before(:each, &@b)
@@ -150,7 +403,7 @@ describe ContextState, "#process" do
     @state.after(:each, &@b)
     @state.it("") { }
     @state.process
-    ScratchPad.recorded.should == [:a, :b]
+    ScratchPad.recorded.should == [:b, :a]
   end
 
   it "calls Mock.cleanup for each it block" do
@@ -169,14 +422,14 @@ describe ContextState, "#process" do
 
   it "calls the describe block" do
     ScratchPad.record []
-    @state.describe(Object, "msg") { ScratchPad << :a }
+    @state.describe { ScratchPad << :a }
     @state.process
     ScratchPad.recorded.should == [:a]
   end
 
   it "creates a new ExampleState instance for each example" do
     ScratchPad.record @state
-    @state.describe("desc") { }
+    @state.describe { }
     @state.it("it") { ScratchPad.record ScratchPad.recorded.state }
     @state.process
     ScratchPad.recorded.should be_kind_of(ExampleState)
@@ -197,14 +450,45 @@ describe ContextState, "#process" do
     @state.process
     MSpec.randomize false
   end
+
+  it "sets the current MSpec ContextState" do
+    MSpec.should_receive(:register_current).with(@state)
+    @state.process
+  end
+
+  it "resets the current MSpec ContextState to nil when there are examples" do
+    MSpec.should_receive(:register_current).with(nil)
+    @state.it("") { }
+    @state.process
+  end
+
+  it "resets the current MSpec ContextState to nil when there are no examples" do
+    MSpec.should_receive(:register_current).with(nil)
+    @state.process
+  end
+
+  it "call #process on children when there are examples" do
+    child = ContextState.new ""
+    child.should_receive(:process)
+    @state.child child
+    @state.it("") { }
+    @state.process
+  end
+
+  it "call #process on children when there are no examples" do
+    child = ContextState.new ""
+    child.should_receive(:process)
+    @state.child child
+    @state.process
+  end
 end
 
 describe ContextState, "#process" do
   before :each do
     MSpec.store :exception, []
 
-    @state = ContextState.new
-    @state.describe("") { }
+    @state = ContextState.new ""
+    @state.describe { }
 
     action = mock("action")
     def action.exception(exc)
@@ -243,8 +527,8 @@ describe ContextState, "#process" do
   before :each do
     MSpec.store :example, []
 
-    @state = ContextState.new
-    @state.describe("") { }
+    @state = ContextState.new ""
+    @state.describe { }
 
     example = mock("example")
     def example.example(state, spec)
@@ -279,8 +563,8 @@ describe ContextState, "#process" do
     MSpec.store :before, []
     MSpec.store :after, []
 
-    @state = ContextState.new
-    @state.describe("") { }
+    @state = ContextState.new ""
+    @state.describe { }
     @state.it("") { MSpec.expectation }
   end
 
@@ -314,16 +598,13 @@ describe ContextState, "#process" do
   end
 end
 
-describe ContextState, "#process" do
-end
-
 describe ContextState, "#process" do
   before :each do
     MSpec.store :enter, []
     MSpec.store :leave, []
 
-    @state = ContextState.new
-    @state.describe("") { }
+    @state = ContextState.new "C#m"
+    @state.describe { }
     @state.it("") { MSpec.expectation }
   end
 
@@ -334,7 +615,7 @@ describe ContextState, "#process" do
 
   it "calls registered enter actions with the current #describe string" do
     enter = mock("enter")
-    enter.should_receive(:enter).and_return { ScratchPad.record :enter }
+    enter.should_receive(:enter).with("C#m").and_return { ScratchPad.record :enter }
     MSpec.register :enter, enter
     @state.process
     ScratchPad.recorded.should == :enter
@@ -354,8 +635,8 @@ describe ContextState, "#process when an exception is raised in before(:all)" do
     MSpec.store :before, []
     MSpec.store :after, []
 
-    @state = ContextState.new
-    @state.describe("") { }
+    @state = ContextState.new ""
+    @state.describe { }
 
     @a = lambda { ScratchPad << :a }
     @b = lambda { ScratchPad << :b }
@@ -414,8 +695,8 @@ describe ContextState, "#process when an exception is raised in before(:each)" d
     MSpec.store :before, []
     MSpec.store :after, []
 
-    @state = ContextState.new
-    @state.describe("") { }
+    @state = ContextState.new ""
+    @state.describe { }
 
     @a = lambda { ScratchPad << :a }
     @b = lambda { ScratchPad << :b }
@@ -463,8 +744,8 @@ describe ContextState, "#process in pretend mode" do
     MSpec.store :before, []
     MSpec.store :after, []
 
-    @state = ContextState.new
-    @state.describe("") { }
+    @state = ContextState.new ""
+    @state.describe { }
     @state.it("") { }
   end
 
@@ -511,8 +792,8 @@ describe ContextState, "#process in pretend mode" do
     MSpec.store :before, []
     MSpec.store :after, []
 
-    @state = ContextState.new
-    @state.describe("") { }
+    @state = ContextState.new ""
+    @state.describe { }
 
     @a = lambda { ScratchPad << :a }
     @b = lambda { ScratchPad << :b }
@@ -521,7 +802,7 @@ describe ContextState, "#process in pretend mode" do
 
   it "calls the describe block" do
     ScratchPad.record []
-    @state.describe(Object, "msg") { ScratchPad << :a }
+    @state.describe { ScratchPad << :a }
     @state.process
     ScratchPad.recorded.should == [:a]
   end
@@ -586,8 +867,8 @@ describe ContextState, "#process in pretend mode" do
     MSpec.store :enter, []
     MSpec.store :leave, []
 
-    @state = ContextState.new
-    @state.describe("") { }
+    @state = ContextState.new ""
+    @state.describe { }
     @state.it("") { }
   end
 
@@ -612,3 +893,87 @@ describe ContextState, "#process in pretend mode" do
     ScratchPad.recorded.should == :leave
   end
 end
+
+describe ContextState, "#it_should_behave_like" do
+  before :each do
+    @shared = ContextState.new("", :shared => true)
+    MSpec.stub!(:retrieve_shared).and_return(@shared)
+
+    @state = ContextState.new ""
+    @a = lambda { }
+    @b = lambda { }
+  end
+
+  it "raises an Exception if unable to find the shared ContextState" do
+    MSpec.should_receive(:retrieve_shared).and_return(nil)
+    lambda { @state.it_should_behave_like "this" }.should raise_error(Exception)
+  end
+
+  it "adds examples from the shared ContextState" do
+    @shared.it "some", &@a
+    @shared.it "thing", &@b
+    @state.it_should_behave_like ""
+    @state.examples.should include(*@shared.examples)
+  end
+
+  it "sets the containing ContextState for the examples" do
+    @shared.it "some", &@a
+    @shared.it "thing", &@b
+    @shared.examples.each { |ex| ex.should_receive(:context=).with(@state) }
+    @state.it_should_behave_like ""
+  end
+
+  it "adds before(:all) blocks from the shared ContextState" do
+    @shared.before :all, &@a
+    @shared.before :all, &@b
+    @state.it_should_behave_like ""
+    @state.before(:all).should include(*@shared.before(:all))
+  end
+
+  it "adds before(:each) blocks from the shared ContextState" do
+    @shared.before :each, &@a
+    @shared.before :each, &@b
+    @state.it_should_behave_like ""
+    @state.before(:each).should include(*@shared.before(:each))
+  end
+
+  it "adds after(:each) blocks from the shared ContextState" do
+    @shared.after :each, &@a
+    @shared.after :each, &@b
+    @state.it_should_behave_like ""
+    @state.after(:each).should include(*@shared.after(:each))
+  end
+
+  it "adds after(:all) blocks from the shared ContextState" do
+    @shared.after :all, &@a
+    @shared.after :all, &@b
+    @state.it_should_behave_like ""
+    @state.after(:all).should include(*@shared.after(:all))
+  end
+end
+
+describe ContextState, "#filter_examples" do
+  before :each do
+    @state = ContextState.new ""
+    @state.it("one") { }
+    @state.it("two") { }
+  end
+
+  it "removes examples that are filtered" do
+    @state.examples.first.stub!(:filtered?).and_return(true)
+    @state.examples.size.should == 2
+    @state.filter_examples
+    @state.examples.size.should == 1
+  end
+
+  it "returns true if there are remaining examples to evaluate" do
+    @state.examples.first.stub!(:filtered?).and_return(true)
+    @state.filter_examples.should be_true
+  end
+
+  it "returns false if there are no remaining examples to evaluate" do
+    @state.examples.first.stub!(:filtered?).and_return(true)
+    @state.examples.last.stub!(:filtered?).and_return(true)
+    @state.filter_examples.should be_false
+  end
+end