rspec-core 2.12.2 → 2.13.0

data/spec/rspec/core/formatters/{text_mate_formatted-1.9.2-jruby.html → text_mate_formatted-2.0.0.html}

@@ -319,15 +319,17 @@ a {
       <span class="duration">n.nnnns</span>
       <div class="failure" id="failure_1">
         <div class="message"><pre>RSpec::Core::Pending::PendingExampleFixedError</pre></div>
-        <div class="backtrace"><pre><a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/resources/formatter_specs.rb&line=18">./spec/rspec/core/resources/formatter_specs.rb:18</a> :in `(root)'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=31">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:31</a> :in `Formatters'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=53">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:53</a> :in `Formatters'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=53">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:53</a> :in `Formatters'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=52">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:52</a> :in `Formatters'</pre></div>
+        <div class="backtrace"><pre><a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/resources/formatter_specs.rb&line=18">./spec/rspec/core/resources/formatter_specs.rb:18</a> :in `block (3 levels) in &lt;top (required)&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=36">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:36</a> :in `block (2 levels) in &lt;module:Formatters&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=58">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:58</a> :in `block (5 levels) in &lt;module:Formatters&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=58">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:58</a> :in `open&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=58">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:58</a> :in `block (4 levels) in &lt;module:Formatters&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=57">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:57</a> :in `chdir&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=57">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:57</a> :in `block (3 levels) in &lt;module:Formatters&gt;&#39;</pre></div>
     <pre class="ruby"><code><span class="linenum">16</span>  <span class="ident">context</span> <span class="punct">&quot;</span><span class="string">with content that would pass</span><span class="punct">&quot;</span> <span class="keyword">do</span>
 <span class="linenum">17</span>    <span class="ident">it</span> <span class="punct">&quot;</span><span class="string">fails</span><span class="punct">&quot;</span> <span class="keyword">do</span>
 <span class="offending"><span class="linenum">18</span>      <span class="ident">pending</span> <span class="keyword">do</span></span>
-<span class="linenum">19</span>        <span class="number">1</span><span class="punct">.</span><span class="ident">should</span> <span class="ident">eq</span><span class="punct">(</span><span class="number">1</span><span class="punct">)</span>
+<span class="linenum">19</span>        <span class="ident">expect</span><span class="punct">(</span><span class="number">1</span><span class="punct">).</span><span class="ident">to</span> <span class="ident">eq</span><span class="punct">(</span><span class="number">1</span><span class="punct">)</span>
 <span class="linenum">20</span>      <span class="keyword">end</span></code></pre>
       </div>
     </dd>
@@ -356,14 +358,16 @@ expected: 2
 
 (compared using ==)
 </pre></div>
-        <div class="backtrace"><pre><a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/resources/formatter_specs.rb&line=33">./spec/rspec/core/resources/formatter_specs.rb:33</a> :in `(root)'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=31">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:31</a> :in `Formatters'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=53">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:53</a> :in `Formatters'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=53">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:53</a> :in `Formatters'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=52">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:52</a> :in `Formatters'</pre></div>
+        <div class="backtrace"><pre><a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/resources/formatter_specs.rb&line=33">./spec/rspec/core/resources/formatter_specs.rb:33</a> :in `block (2 levels) in &lt;top (required)&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=36">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:36</a> :in `block (2 levels) in &lt;module:Formatters&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=58">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:58</a> :in `block (5 levels) in &lt;module:Formatters&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=58">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:58</a> :in `open&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=58">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:58</a> :in `block (4 levels) in &lt;module:Formatters&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=57">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:57</a> :in `chdir&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=57">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:57</a> :in `block (3 levels) in &lt;module:Formatters&gt;&#39;</pre></div>
     <pre class="ruby"><code><span class="linenum">31</span><span class="ident">describe</span> <span class="punct">&quot;</span><span class="string">failing spec</span><span class="punct">&quot;</span> <span class="keyword">do</span>
 <span class="linenum">32</span>  <span class="ident">it</span> <span class="punct">&quot;</span><span class="string">fails</span><span class="punct">&quot;</span> <span class="keyword">do</span>
-<span class="offending"><span class="linenum">33</span>    <span class="number">1</span><span class="punct">.</span><span class="ident">should</span> <span class="ident">eq</span><span class="punct">(</span><span class="number">2</span><span class="punct">)</span></span>
+<span class="offending"><span class="linenum">33</span>    <span class="ident">expect</span><span class="punct">(</span><span class="number">1</span><span class="punct">).</span><span class="ident">to</span> <span class="ident">eq</span><span class="punct">(</span><span class="number">2</span><span class="punct">)</span></span>
 <span class="linenum">34</span>  <span class="keyword">end</span>
 <span class="linenum">35</span><span class="keyword">end</span></code></pre>
       </div>
@@ -381,12 +385,14 @@ expected: 2
       <span class="duration">n.nnnns</span>
       <div class="failure" id="failure_3">
         <div class="message"><pre>foo</pre></div>
-        <div class="backtrace"><pre>(erb):1:in `result'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/resources/formatter_specs.rb&line=41">./spec/rspec/core/resources/formatter_specs.rb:41</a> :in `(root)'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=31">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:31</a> :in `Formatters'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=53">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:53</a> :in `Formatters'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=53">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:53</a> :in `Formatters'
-<a href="txmt://open?url=file:///Users/alindeman/workspace/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=52">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:52</a> :in `Formatters'</pre></div>
+        <div class="backtrace"><pre>(erb):1:in `&lt;main&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/resources/formatter_specs.rb&line=41">./spec/rspec/core/resources/formatter_specs.rb:41</a> :in `block (2 levels) in &lt;top (required)&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=36">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:36</a> :in `block (2 levels) in &lt;module:Formatters&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=58">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:58</a> :in `block (5 levels) in &lt;module:Formatters&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=58">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:58</a> :in `open&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=58">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:58</a> :in `block (4 levels) in &lt;module:Formatters&gt;&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=57">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:57</a> :in `chdir&#39;
+<a href="txmt://open?url=file:///Users/myron/code/rspec-dev/repos/rspec-core/spec/rspec/core/formatters/text_mate_formatter_spec.rb&line=57">./spec/rspec/core/formatters/text_mate_formatter_spec.rb:57</a> :in `block (3 levels) in &lt;module:Formatters&gt;&#39;</pre></div>
     <pre class="ruby"><code><span class="linenum">-1</span><span class="comment"># Couldn't get snippet for (erb)</span></code></pre>
       </div>
     </dd>
@@ -396,7 +402,7 @@ expected: 2
       <span class="duration">n.nnnns</span>
       <div class="failure" id="failure_4">
         <div class="message"><pre>Exception</pre></div>
-        <div class="backtrace"><pre><a href="txmt://open?url=file:///foo.html.erb&line=1">/foo.html.erb:1</a> :in `&lt;main&gt;': foo (RuntimeError)</pre></div>
+        <div class="backtrace"><pre><a href="txmt://open?url=file:///foo.html.erb&line=1">/foo.html.erb:1</a> :in `&lt;main&gt;&#39;: foo (RuntimeError)</pre></div>
     <pre class="ruby"><code><span class="linenum">-1</span><span class="comment"># Couldn't get snippet for /foo.html.erb</span></code></pre>
       </div>
     </dd>

data/spec/rspec/core/formatters/text_mate_formatter_spec.rb

@@ -27,7 +27,11 @@ module RSpec
             %w[spec/rspec/core/resources/formatter_specs.rb --format textmate --order default]
           )
           options.parse_options
+
           err, out = StringIO.new, StringIO.new
+          err.set_encoding("utf-8") if err.respond_to?(:set_encoding)
+          out.set_encoding("utf-8") if out.respond_to?(:set_encoding)
+
           command_line = RSpec::Core::CommandLine.new(options)
           command_line.run(err, out)
           out.string.gsub(/\d+\.\d+(s| seconds)/, "n.nnnn\\1")
@@ -65,10 +69,10 @@ module RSpec
             expected_doc = Nokogiri::HTML(expected_html)
             expected_doc.search("div.backtrace").remove
 
-            actual_doc.inner_html.should eq(expected_doc.inner_html)
+            expect(actual_doc.inner_html).to eq(expected_doc.inner_html)
 
             backtrace_lines.each do |backtrace_line|
-              backtrace_line['href'].should include("txmt://open?url=")
+              expect(backtrace_line['href']).to include("txmt://open?url=")
             end
           end
         end
@@ -77,12 +81,12 @@ module RSpec
           Dir.chdir(root) do
             actual_doc = Nokogiri::HTML(generated_html)
 
-            actual_doc.inner_html.should include('(erb):1')
+            expect(actual_doc.inner_html).to include('(erb):1')
           end
         end
 
         it "has a backtrace line from a erb source file we forced to appear" do
-          generated_html.should include('open?url=file:///foo.html.erb')
+          expect(generated_html).to include('open?url=file:///foo.html.erb')
         end
 
       end

data/spec/rspec/core/hooks_filtering_spec.rb

@@ -15,7 +15,7 @@ module RSpec::Core
         group = ExampleGroup.describe
         group.example("example") {}
         group.run
-        filters.should eq([
+        expect(filters).to eq([
           "before all in config",
           "around each in config",
           "before each in config",
@@ -38,7 +38,7 @@ module RSpec::Core
           group = ExampleGroup.describe(:match => true)
           group.example("example") {}
           group.run
-          filters.should eq([
+          expect(filters).to eq([
             "around each in config",
             "before each in config",
             "after each in config"
@@ -58,7 +58,7 @@ module RSpec::Core
         group = ExampleGroup.describe(:match => true)
         group.example("example") {}
         group.run
-        filters.should eq([
+        expect(filters).to eq([
           "before all in config",
           "around each in config",
           "before each in config",
@@ -84,9 +84,9 @@ module RSpec::Core
         end
         group.run
 
-        example_1_filters.should be_empty
-        example_2_filters.should eq([:before_all])
-        filters.should eq([:before_all, :after_all])
+        expect(example_1_filters).to be_empty
+        expect(example_2_filters).to eq([:before_all])
+        expect(filters).to eq([:before_all, :after_all])
       end
 
       it "runs before|after :all hooks only on the highest level group that matches the filter" do
@@ -109,11 +109,11 @@ module RSpec::Core
         end
         group.run
 
-        example_1_filters.should eq([:before_all])
-        example_2_filters.should eq([:before_all])
-        example_3_filters.should eq([:before_all])
+        expect(example_1_filters).to eq([:before_all])
+        expect(example_2_filters).to eq([:before_all])
+        expect(example_3_filters).to eq([:before_all])
 
-        filters.should eq([:before_all, :after_all])
+        expect(filters).to eq([:before_all, :after_all])
       end
 
       it "does not run if the filter doesn't match the example group's filter" do
@@ -128,7 +128,7 @@ module RSpec::Core
         group = ExampleGroup.describe(:match => true)
         group.example("example") {}
         group.run
-        filters.should eq([])
+        expect(filters).to eq([])
       end
 
       context "when the hook filters apply to individual examples instead of example groups" do
@@ -164,7 +164,7 @@ module RSpec::Core
           let(:example_metadata) { { :foo => :bar } }
 
           it "runs the `:each` hooks" do
-            each_filters.should eq([
+            expect(each_filters).to eq([
               'around each in config',
               'before each in config',
               'after each in config'
@@ -172,7 +172,7 @@ module RSpec::Core
           end
 
           it "does not run the `:all` hooks" do
-            all_filters.should be_empty
+            expect(all_filters).to be_empty
           end
         end
 
@@ -180,7 +180,7 @@ module RSpec::Core
           let(:example_metadata) { { :foo => :bazz } }
 
           it "does not run any of the hooks" do
-            filters.should be_empty
+            expect(filters).to be_empty
           end
         end
       end
@@ -199,7 +199,7 @@ module RSpec::Core
         group = ExampleGroup.describe(:one => 1, :two => 2, :three => 3)
         group.example("example") {}
         group.run
-        filters.should eq([
+        expect(filters).to eq([
           "before all in config",
           "around each in config",
           "before each in config",
@@ -220,7 +220,7 @@ module RSpec::Core
         group = ExampleGroup.describe(:one => 1, :two => 2, :three => 3)
         group.example("example") {}
         group.run
-        filters.should eq([])
+        expect(filters).to eq([])
       end
     end
   end

data/spec/rspec/core/hooks_spec.rb

@@ -35,13 +35,13 @@ module RSpec::Core
             it "defaults to :each scope if no arguments are given" do
               hooks = instance.send(type) {}
               hook = hooks.first
-              instance.hooks[type][:each].should include(hook)
+              expect(instance.hooks[type][:each]).to include(hook)
             end
 
             it "defaults to :each scope if the only argument is a metadata hash" do
               hooks = instance.send(type, :foo => :bar) {}
               hook = hooks.first
-              instance.hooks[type][:each].should include(hook)
+              expect(instance.hooks[type][:each]).to include(hook)
             end
 
             it "raises an error if only metadata symbols are given as arguments" do
@@ -68,11 +68,11 @@ module RSpec::Core
               end
 
               it "does not make #{scope.inspect} a metadata key" do
-                hook.options.should be_empty
+                expect(hook.options).to be_empty
               end
 
               it "is scoped to #{scope.inspect}" do
-                instance.hooks[type][scope].should include(hook)
+                expect(instance.hooks[type][scope]).to include(hook)
               end
             end
           end
@@ -92,7 +92,7 @@ module RSpec::Core
             end
           end
           group.run
-          examples.should have(0).example
+          expect(examples).to have(0).example
         end
       end
 
@@ -108,7 +108,7 @@ module RSpec::Core
             end
           end
           group.run
-          examples.should have(1).example
+          expect(examples).to have(1).example
         end
       end
 
@@ -128,7 +128,7 @@ module RSpec::Core
             end
           end
           group.run
-          examples.should have(1).example
+          expect(examples).to have(1).example
         end
       end
     end
@@ -151,7 +151,7 @@ module RSpec::Core
 
           group.run
 
-          messages.should eq([
+          expect(messages).to eq([
             'group 1',
             'group 2',
             'config 1',
@@ -179,7 +179,7 @@ module RSpec::Core
 
           group.run
 
-          messages.should eq([
+          expect(messages).to eq([
             'config 1',
             'config 2',
             'config 3',
@@ -205,7 +205,7 @@ module RSpec::Core
 
           group.run
 
-          messages.should eq([
+          expect(messages).to eq([
             'group 1',
             'group 2',
             'group 3',
@@ -233,7 +233,7 @@ module RSpec::Core
 
           group.run
 
-          messages.should eq([
+          expect(messages).to eq([
             'group 1',
             'group 2',
             'config 1',

data/spec/rspec/core/kernel_extensions_spec.rb

@@ -3,7 +3,7 @@ require 'spec_helper'
 describe "extensions" do
   describe "debugger" do
     it "is defined on Kernel" do
-      Kernel.should respond_to(:debugger)
+      expect(Kernel).to respond_to(:debugger)
     end
   end
 end

data/spec/rspec/core/memoized_helpers_spec.rb

@@ -0,0 +1,458 @@
+require 'spec_helper'
+
+module RSpec::Core
+  describe MemoizedHelpers do
+    before(:each) { RSpec.configuration.configure_expectation_framework }
+
+    def subject_value_for(describe_arg, &block)
+      group = ExampleGroup.describe(describe_arg, &block)
+      subject_value = nil
+      group.example { subject_value = subject }
+      group.run
+      subject_value
+    end
+
+    describe "implicit subject" do
+      describe "with a class" do
+        it "returns an instance of the class" do
+          expect(subject_value_for(Array)).to eq([])
+        end
+      end
+
+      describe "with a Module" do
+        it "returns the Module" do
+          expect(subject_value_for(Enumerable)).to eq(Enumerable)
+        end
+      end
+
+      describe "with a string" do
+        it "returns the string" do
+          expect(subject_value_for("Foo")).to eq("Foo")
+        end
+      end
+
+      describe "with a number" do
+        it "returns the number" do
+          expect(subject_value_for(15)).to eq(15)
+        end
+      end
+
+      it "can be overriden and super'd to from a nested group" do
+        outer_subject_value = inner_subject_value = nil
+
+        ExampleGroup.describe(Array) do
+          subject { super() << :parent_group }
+          example { outer_subject_value = subject }
+
+          context "nested" do
+            subject { super() << :child_group }
+            example { inner_subject_value = subject }
+          end
+        end.run
+
+        expect(outer_subject_value).to eq([:parent_group])
+        expect(inner_subject_value).to eq([:parent_group, :child_group])
+      end
+    end
+
+    describe "explicit subject" do
+      [false, nil].each do |falsy_value|
+        context "with a value of #{falsy_value.inspect}" do
+          it "is evaluated once per example" do
+            group = ExampleGroup.describe(Array)
+            group.before do
+              Object.should_receive(:this_question?).once.and_return(falsy_value)
+            end
+            group.subject do
+              Object.this_question?
+            end
+            group.example do
+              subject
+              subject
+            end
+            expect(group.run).to be_true, "expected subject block to be evaluated only once"
+          end
+        end
+      end
+
+      describe "defined in a top level group" do
+        it "replaces the implicit subject in that group" do
+          subject_value = subject_value_for(Array) do
+            subject { [1, 2, 3] }
+          end
+          expect(subject_value).to eq([1, 2, 3])
+        end
+      end
+
+      describe "defined in a top level group" do
+        let(:group) do
+          ExampleGroup.describe do
+            subject{ [4, 5, 6] }
+          end
+        end
+
+        it "is available in a nested group (subclass)" do
+          subject_value = nil
+          group.describe("I'm nested!") do
+            example { subject_value = subject }
+          end.run
+
+          expect(subject_value).to eq([4, 5, 6])
+        end
+
+        it "is available in a doubly nested group (subclass)" do
+          subject_value = nil
+          group.describe("Nesting level 1") do
+            describe("Nesting level 2") do
+              example { subject_value = subject }
+            end
+          end.run
+
+          expect(subject_value).to eq([4, 5, 6])
+        end
+
+        it "can be overriden and super'd to from a nested group" do
+          subject_value = nil
+          group.describe("Nested") do
+            subject { super() + [:override] }
+            example { subject_value = subject }
+          end.run
+
+          expect(subject_value).to eq([4, 5, 6, :override])
+        end
+      end
+
+      describe "with a name" do
+        it "defines a method that returns the memoized subject" do
+          list_value_1 = list_value_2 = subject_value_1 = subject_value_2 = nil
+
+          ExampleGroup.describe do
+            subject(:list) { [1, 2, 3] }
+            example do
+              list_value_1 = list
+              list_value_2 = list
+              subject_value_1 = subject
+              subject_value_2 = subject
+            end
+          end.run
+
+          expect(list_value_1).to eq([1, 2, 3])
+          expect(list_value_1).to equal(list_value_2)
+
+          expect(subject_value_1).to equal(subject_value_2)
+          expect(subject_value_1).to equal(list_value_1)
+        end
+
+        it "is referred from inside subject by the name" do
+          inner_subject_value = nil
+
+          ExampleGroup.describe do
+            subject(:list) { [1, 2, 3] }
+            describe 'first' do
+              subject(:first_element) { list.first }
+              example { inner_subject_value = subject }
+            end
+          end.run
+
+          expect(inner_subject_value).to eq(1)
+        end
+
+        context 'when `super` is used' do
+          it "delegates to the parent context's `subject`, not the named mehtod" do
+            inner_subject_value = nil
+
+            ExampleGroup.describe do
+              let(:list) { ["a", "b", "c"] }
+              subject { [1, 2, 3] }
+
+              describe 'first' do
+                subject(:list) { super().first(2) }
+                example { inner_subject_value = subject }
+              end
+            end.run
+
+            expect(inner_subject_value).to eq([1, 2])
+          end
+        end
+      end
+    end
+
+    context "using 'self' as an explicit subject" do
+      it "delegates matcher to the ExampleGroup" do
+        group = ExampleGroup.describe("group") do
+          subject { self }
+          def ok?; true; end
+          def not_ok?; false; end
+
+          it { should eq(self) }
+          it { should be_ok }
+          it { should_not be_not_ok }
+        end
+
+        expect(group.run).to be_true
+      end
+    end
+
+    describe "#its" do
+      subject do
+        Class.new do
+          def initialize
+            @call_count = 0
+          end
+
+          def call_count
+            @call_count += 1
+          end
+        end.new
+      end
+
+      context "with a call counter" do
+        its(:call_count) { should eq(1) }
+      end
+
+      context "with nil value" do
+        subject do
+          Class.new do
+            def nil_value
+              nil
+            end
+          end.new
+        end
+        its(:nil_value) { should be_nil }
+      end
+
+      context "with nested attributes" do
+        subject do
+          Class.new do
+            def name
+              "John"
+            end
+          end.new
+        end
+        its("name")            { should eq("John") }
+        its("name.size")       { should eq(4) }
+        its("name.size.class") { should eq(Fixnum) }
+      end
+
+      context "when it responds to #[]" do
+        subject do
+          Class.new do
+            def [](*objects)
+              objects.map do |object|
+                "#{object.class}: #{object.to_s}"
+              end.join("; ")
+            end
+
+            def name
+              "George"
+            end
+          end.new
+        end
+        its([:a]) { should eq("Symbol: a") }
+        its(['a']) { should eq("String: a") }
+        its([:b, 'c', 4]) { should eq("Symbol: b; String: c; Fixnum: 4") }
+        its(:name) { should eq("George") }
+        context "when referring to an attribute without the proper array syntax" do
+          context "it raises an error" do
+            its(:age) do
+              expect do
+                should eq(64)
+              end.to raise_error(NoMethodError)
+            end
+          end
+        end
+      end
+
+      context "when it does not respond to #[]" do
+        subject { Object.new }
+
+        context "it raises an error" do
+          its([:a]) do
+            expect do
+              should eq("Symbol: a")
+            end.to raise_error(NoMethodError)
+          end
+        end
+      end
+
+      context "calling and overriding super" do
+        it "calls to the subject defined in the parent group" do
+          group = ExampleGroup.describe(Array) do
+            subject { [1, 'a'] }
+
+            its(:last) { should eq("a") }
+
+            describe '.first' do
+              def subject; super().first; end
+
+              its(:next) { should eq(2) }
+            end
+          end
+
+          expect(group.run).to be_true
+        end
+      end
+
+      context "with nil subject" do
+        subject do
+          Class.new do
+            def initialize
+              @counter = -1
+            end
+            def nil_if_first_time
+              @counter += 1
+              @counter == 0 ? nil : true
+            end
+          end.new
+        end
+        its(:nil_if_first_time) { should be(nil) }
+      end
+
+      context "with false subject" do
+        subject do
+          Class.new do
+            def initialize
+              @counter = -1
+            end
+            def false_if_first_time
+              @counter += 1
+              @counter > 0
+            end
+          end.new
+        end
+        its(:false_if_first_time) { should be(false) }
+      end
+
+      describe 'accessing `subject` in `before` and `let`' do
+        subject { 'my subject' }
+        before { @subject_in_before = subject }
+        let(:subject_in_let) { subject }
+        let!(:eager_loaded_subject_in_let) { subject }
+
+        # These examples read weird, because we're actually
+        # specifying the behaviour of `its` itself
+        its(nil) { expect(subject).to eq('my subject') }
+        its(nil) { expect(@subject_in_before).to eq('my subject') }
+        its(nil) { expect(subject_in_let).to eq('my subject') }
+        its(nil) { expect(eager_loaded_subject_in_let).to eq('my subject') }
+      end
+    end
+
+    describe '#subject!' do
+      let(:prepared_array) { [1,2,3] }
+      subject! { prepared_array.pop }
+
+      it "evaluates subject before example" do
+        expect(prepared_array).to eq([1,2])
+      end
+
+      it "returns memoized value from first invocation" do
+        expect(subject).to eq(3)
+      end
+    end
+  end
+
+  describe "#let" do
+    let(:counter) do
+      Class.new do
+        def initialize
+          @count = 0
+        end
+        def count
+          @count += 1
+        end
+      end.new
+    end
+
+    let(:nil_value) do
+      @nil_value_count += 1
+      nil
+    end
+
+    it "generates an instance method" do
+      expect(counter.count).to eq(1)
+    end
+
+    it "caches the value" do
+      expect(counter.count).to eq(1)
+      expect(counter.count).to eq(2)
+    end
+
+    it "caches a nil value" do
+      @nil_value_count = 0
+      nil_value
+      nil_value
+
+      expect(@nil_value_count).to eq(1)
+    end
+
+    let(:a_value) { "a string" }
+
+    context 'when overriding let in a nested context' do
+      let(:a_value) { super() + " (modified)" }
+
+      it 'can use `super` to reference the parent context value' do
+        expect(a_value).to eq("a string (modified)")
+      end
+    end
+
+    context 'when the declaration uses `return`' do
+      let(:value) do
+        return :early_exit if @early_exit
+        :late_exit
+      end
+
+      it 'can exit the let declaration early' do
+        @early_exit = true
+        expect(value).to eq(:early_exit)
+      end
+
+      it 'can get past a conditional `return` statement' do
+        @early_exit = false
+        expect(value).to eq(:late_exit)
+      end
+    end
+  end
+
+  describe "#let!" do
+    subject { [1,2,3] }
+    let!(:popped) { subject.pop }
+
+    it "evaluates the value non-lazily" do
+      expect(subject).to eq([1,2])
+    end
+
+    it "returns memoized value from first invocation" do
+      expect(popped).to eq(3)
+    end
+  end
+
+  describe 'using subject in before and let blocks' do
+    shared_examples_for 'a subject' do
+      let(:subject_id_in_let) { subject.object_id }
+      before { @subject_id_in_before = subject.object_id }
+
+      it 'should be memoized' do
+        expect(subject_id_in_let).to eq(@subject_id_in_before)
+      end
+
+      it { should eq(subject) }
+    end
+
+    describe Object do
+      context 'with implicit subject' do
+        it_should_behave_like 'a subject'
+      end
+
+      context 'with explicit subject' do
+        subject { Object.new }
+        it_should_behave_like 'a subject'
+      end
+
+      context 'with a constant subject'do
+        subject { 123 }
+        it_should_behave_like 'a subject'
+      end
+    end
+  end
+end