rspec-core 2.5.2 → 2.6.0.rc2

data/features/metadata/current_example.feature

@@ -0,0 +1,17 @@
+Feature: current example
+
+  You can reference the example object, and access its metadata, using
+  the `example` method within an example.
+
+  Scenario: access the example object from within an example
+    Given a file named "spec/example_spec.rb" with:
+      """
+      describe "an example" do
+        it "knows itself as example" do
+          example.description.should eq("knows itself as example")
+        end
+      end
+      """
+    When I run `rspec spec/example_spec.rb`
+    Then the example should pass
+

data/features/metadata/described_class.feature

@@ -12,6 +12,6 @@ Feature: described class
         end
       end
       """
-    When I run "rspec ./spec/example_spec.rb"
-    Then the examples should all pass
+    When I run `rspec spec/example_spec.rb`
+    Then the example should pass
 

data/features/metadata/user_defined.feature

@@ -0,0 +1,111 @@
+Feature: User-defined metadata
+
+  You can attach user-defined metadata to any example group or example.
+  Pass a hash as the last argument (before the block) to `describe`,
+  `context` or `it`.  RSpec supports many configuration options that apply
+  only to certain examples or groups based on the metadata.
+
+  Metadata defined on an example group is available (and can be overriden)
+  by any sub-group or from any example in that group or a sub-group.
+
+  In addition, there is a configuration option (which will be the default
+  behavior in RSpec 3) that allows you to specify metadata using just
+  symbols:
+
+    RSpec.configure do |c|
+      c.treat_symbols_as_metadata_keys_with_true_values = true
+    end
+
+  Each symbol passed as an argument to `describe`, `context` or `it` will
+  be a key in the metadata hash, with a corresponding value of `true`.
+
+  Scenario: define group metadata using a hash
+    Given a file named "define_group_metadata_with_hash_spec.rb" with:
+      """
+      describe "a group with user-defined metadata", :foo => 17 do
+        it 'has access to the metadata in the example' do
+          example.metadata[:foo].should == 17
+        end
+
+        it 'does not have access to metadata defined on sub-groups' do
+          example.metadata.should_not include(:bar)
+        end
+
+        describe 'a sub-group with user-defined metadata', :bar => 12 do
+          it 'has access to the sub-group metadata' do
+            example.metadata[:foo].should == 17
+          end
+
+          it 'also has access to metadata defined on parent groups' do
+            example.metadata[:bar].should == 12
+          end
+        end
+      end
+      """
+    When I run `rspec define_group_metadata_with_hash_spec.rb`
+    Then the examples should all pass
+
+  Scenario: define example metadata using a hash
+    Given a file named "define_example_metadata_with_hash_spec.rb" with:
+      """
+      describe "a group with no user-defined metadata" do
+        it 'has an example with metadata', :foo => 17 do
+          example.metadata[:foo].should == 17
+          example.metadata.should_not include(:bar)
+        end
+
+        it 'has another example with metadata', :bar => 12, :bazz => 33 do
+          example.metadata[:bar].should == 12
+          example.metadata[:bazz].should == 33
+          example.metadata.should_not include(:foo)
+        end
+      end
+      """
+    When I run `rspec define_example_metadata_with_hash_spec.rb`
+    Then the examples should all pass
+
+  Scenario: override user-defined metadata
+    Given a file named "override_metadata_spec.rb" with:
+      """
+      describe "a group with user-defined metadata", :foo => 'bar' do
+        it 'can be overriden by an example', :foo => 'bazz' do
+          example.metadata[:foo].should == 'bazz'
+        end
+
+        describe "a sub-group with an override", :foo => 'goo' do
+          it 'can be overriden by a sub-group' do
+            example.metadata[:foo].should == 'goo'
+          end
+        end
+      end
+      """
+    When I run `rspec override_metadata_spec.rb`
+    Then the examples should all pass
+
+  Scenario: less verbose metadata
+    Given a file named "less_verbose_metadata_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        c.treat_symbols_as_metadata_keys_with_true_values = true
+      end
+
+      describe "a group with simple metadata", :fast, :simple, :bug => 73 do
+        it 'has `:fast => true` metadata' do
+          example.metadata[:fast].should == true
+        end
+
+        it 'has `:simple => true` metadata' do
+          example.metadata[:simple].should == true
+        end
+
+        it 'can still use a hash for metadata' do
+          example.metadata[:bug].should == 73
+        end
+
+        it 'can define simple metadata on an example', :special do
+          example.metadata[:special].should == true
+        end
+      end
+      """
+    When I run `rspec less_verbose_metadata_spec.rb`
+    Then the examples should all pass

data/features/mock_framework_integration/use_any_framework.feature

@@ -100,7 +100,7 @@ Feature: mock with an alternative framework
         end
       end
       """
-    When I run "rspec example_spec.rb --format doc"
+    When I run `rspec example_spec.rb --format doc`
     Then the exit status should be 1
     And the output should contain "2 examples, 1 failure" 
     And the output should contain "fails when message is received (FAILED - 1)" 

data/features/mock_framework_integration/use_flexmock.feature

@@ -1,23 +1,96 @@
 Feature: mock with flexmock
 
-  As an RSpec user who likes to mock
-  I want to be able to use flexmock
+  Configure RSpec to use flexmock as shown in the scenarios below.
 
-  Scenario: Mock with flexmock
-    Given a file named "flexmock_example_spec.rb" with:
+  Scenario: passing message expectation
+    Given a file named "example_spec.rb" with:
       """
       RSpec.configure do |config|
         config.mock_framework = :flexmock
       end
 
-      describe "plugging in flexmock" do
-        it "allows flexmock to be used" do
-          target = Object.new
-          flexmock(target).should_receive(:foo).once
-          target.foo
+      describe "mocking with RSpec" do
+        it "passes when it should" do
+          receiver = flexmock('receiver')
+          receiver.should_receive(:message).once
+          receiver.message
         end
       end
       """
-    When I run "rspec ./flexmock_example_spec.rb"
+    When I run `rspec example_spec.rb`
     Then the examples should all pass 
+
+  Scenario: failing message expecation
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :flexmock
+      end
+
+      describe "mocking with RSpec" do
+        it "fails when it should" do
+          receiver = flexmock('receiver')
+          receiver.should_receive(:message).once
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "1 example, 1 failure"
+
+  Scenario: failing message expectation in pending block (remains pending)
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :flexmock
+      end
+
+      describe "failed message expectation in a pending block" do
+        it "is listed as pending" do
+          pending do
+            receiver = flexmock('receiver')
+            receiver.should_receive(:message).once
+          end
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "1 example, 0 failures, 1 pending"
     And the exit status should be 0
+
+  Scenario: passing message expectation in pending block (fails)
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :flexmock
+      end
+
+      describe "passing message expectation in a pending block" do
+        it "fails with FIXED" do
+          pending do
+            receiver = flexmock('receiver')
+            receiver.should_receive(:message).once
+            receiver.message
+          end
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "FIXED"
+    Then the output should contain "1 example, 1 failure"
+    And the exit status should be 1
+
+  Scenario: accessing RSpec.configuration.mock_framework.framework_name 
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :flexmock
+      end
+
+      describe "RSpec.configuration.mock_framework.framework_name" do
+        it "returns :flexmock" do
+          RSpec.configuration.mock_framework.framework_name.should eq(:flexmock)
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the examples should all pass 

data/features/mock_framework_integration/use_mocha.feature

@@ -1,23 +1,97 @@
 Feature: mock with mocha
 
-  As an RSpec user who likes to mock
-  I want to be able to use mocha
+  Configure RSpec to use mocha as shown in the scenarios below.
 
-  Scenario: Mock with mocha
-    Given a file named "mocha_example_spec.rb" with:
+  Scenario: passing message expectation
+    Given a file named "example_spec.rb" with:
       """
       RSpec.configure do |config|
         config.mock_framework = :mocha
       end
 
-      describe "plugging in mocha" do
-        it "allows mocha to be used" do
-          target = Object.new
-          target.expects(:foo).once
-          target.foo
+      describe "mocking with RSpec" do
+        it "passes when it should" do
+          receiver = mock('receiver')
+          receiver.expects(:message).once
+          receiver.message
         end
       end
       """
-    When I run "rspec ./mocha_example_spec.rb"
+    When I run `rspec example_spec.rb`
     Then the examples should all pass 
+
+  Scenario: failing message expecation
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :mocha
+      end
+
+      describe "mocking with RSpec" do
+        it "fails when it should" do
+          receiver = mock('receiver')
+          receiver.expects(:message).once
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "1 example, 1 failure"
+
+  Scenario: failing message expectation in pending block (remains pending)
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :mocha
+      end
+
+      describe "failed message expectation in a pending block" do
+        it "is listed as pending" do
+          pending do
+            receiver = mock('receiver')
+            receiver.expects(:message).once
+          end
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "1 example, 0 failures, 1 pending"
     And the exit status should be 0
+
+  Scenario: passing message expectation in pending block (fails)
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :mocha
+      end
+
+      describe "passing message expectation in a pending block" do
+        it "fails with FIXED" do
+          pending do
+            receiver = mock('receiver')
+            receiver.expects(:message).once
+            receiver.message
+          end
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "FIXED"
+    Then the output should contain "1 example, 1 failure"
+    And the exit status should be 1
+
+  Scenario: accessing RSpec.configuration.mock_framework.framework_name 
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :mocha
+      end
+
+      describe "RSpec.configuration.mock_framework.framework_name" do
+        it "returns :mocha" do
+          RSpec.configuration.mock_framework.framework_name.should eq(:mocha)
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the examples should all pass 
+

data/features/mock_framework_integration/use_rr.feature

@@ -1,23 +1,98 @@
 Feature: mock with rr
 
-  As an RSpec user who likes to mock
-  I want to be able to use rr
+  Configure RSpec to use rr as shown in the scenarios below.
 
-  Scenario: Mock with rr
-    Given a file named "rr_example_spec.rb" with:
+  Scenario: passing message expectation
+    Given a file named "example_spec.rb" with:
       """
       RSpec.configure do |config|
         config.mock_framework = :rr
       end
 
-      describe "plugging in rr" do
-        it "allows rr to be used" do
-          target = Object.new
-          mock(target).foo
-          target.foo
+      describe "mocking with RSpec" do
+        it "passes when it should" do
+          receiver = Object.new
+          mock(receiver).message
+          receiver.message
         end
       end
       """
-    When I run "rspec ./rr_example_spec.rb"
+    When I run `rspec example_spec.rb`
     Then the examples should all pass 
+
+  Scenario: failing message expecation
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :rr
+      end
+
+      describe "mocking with RSpec" do
+        it "fails when it should" do
+          receiver = Object.new
+          mock(receiver).message
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "1 example, 1 failure"
+
+  Scenario: failing message expectation in pending block (remains pending)
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :rr
+      end
+
+      describe "failed message expectation in a pending block" do
+        it "is listed as pending" do
+          pending do
+            receiver = Object.new
+            mock(receiver).message
+          end
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "1 example, 0 failures, 1 pending"
     And the exit status should be 0
+
+  Scenario: passing message expectation in pending block (fails)
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :rr
+      end
+
+      describe "passing message expectation in a pending block" do
+        it "fails with FIXED" do
+          pending do
+            receiver = Object.new
+            mock(receiver).message
+            receiver.message
+          end
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "FIXED"
+    Then the output should contain "1 example, 1 failure"
+    And the exit status should be 1
+
+  Scenario: accessing RSpec.configuration.mock_framework.framework_name 
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.mock_framework = :rr
+      end
+
+      describe "RSpec.configuration.mock_framework.framework_name" do
+        it "returns :rr" do
+          RSpec.configuration.mock_framework.framework_name.should eq(:rr)
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the examples should all pass 
+
+