rspec-core 2.99.2 → 3.0.0.beta1

data/features/configuration/custom_settings.feature

@@ -11,21 +11,21 @@ Feature: custom settings
 
       describe "custom setting" do
         it "is nil by default" do
-          RSpec.configuration.custom_setting.should be_nil
+          expect(RSpec.configuration.custom_setting).to be_nil
         end
 
         it "acts false by default" do
-          RSpec.configuration.custom_setting.should be_falsey
+          expect(RSpec.configuration.custom_setting).to be_falsey
         end
 
         it "is exposed as a predicate" do
-          RSpec.configuration.custom_setting?.should be_falsey
+          expect(RSpec.configuration.custom_setting?).to be_falsey
         end
 
         it "can be overridden" do
           RSpec.configuration.custom_setting = true
-          RSpec.configuration.custom_setting.should be_truthy
-          RSpec.configuration.custom_setting?.should be_truthy
+          expect(RSpec.configuration.custom_setting).to be_truthy
+          expect(RSpec.configuration.custom_setting?).to be_truthy
         end
       end
       """
@@ -41,17 +41,17 @@ Feature: custom settings
 
       describe "custom setting" do
         it "is true by default" do
-          RSpec.configuration.custom_setting.should be_truthy
+          expect(RSpec.configuration.custom_setting).to be_truthy
         end
 
         it "is exposed as a predicate" do
-          RSpec.configuration.custom_setting?.should be_truthy
+          expect(RSpec.configuration.custom_setting?).to be_truthy
         end
 
         it "can be overridden" do
           RSpec.configuration.custom_setting = false
-          RSpec.configuration.custom_setting.should be_falsey
-          RSpec.configuration.custom_setting?.should be_falsey
+          expect(RSpec.configuration.custom_setting).to be_falsey
+          expect(RSpec.configuration.custom_setting?).to be_falsey
         end
       end
       """
@@ -71,11 +71,11 @@ Feature: custom settings
 
       describe "custom setting" do
         it "returns the value set in the last cofigure block to get eval'd" do
-          RSpec.configuration.custom_setting.should be_truthy
+          expect(RSpec.configuration.custom_setting).to be_truthy
         end
 
         it "is exposed as a predicate" do
-          RSpec.configuration.custom_setting?.should be_truthy
+          expect(RSpec.configuration.custom_setting?).to be_truthy
         end
       end
       """

data/features/configuration/overriding_global_ordering.feature

@@ -0,0 +1,93 @@
+Feature: Overriding global ordering
+
+  You can customize how RSpec orders examples and example groups.
+  For an individual group, you can control it by tagging it with
+  `:order` metadata:
+
+    * `:defined` runs the examples (and sub groups) in defined order.
+    * `:random` runs them in random order.
+
+  If you have more specialized needs, you can register your own ordering
+  using the `register_ordering` configuration option. If you register
+  an ordering as `:global`, it will be the global default, used by all
+  groups that do not have `:order` metadata (and by RSpec to order the
+  top-level groups).
+
+  Scenario: running a specific examples group in order
+    Given a file named "order_dependent_spec.rb" with:
+      """ruby
+      describe "examples only pass when they are run in order", :order => :defined do
+        before(:all) { @list = [] }
+
+        it "passes when run first" do
+          @list << 1
+          expect(@list).to eq([1])
+        end
+
+        it "passes when run second" do
+          @list << 2
+          expect(@list).to eq([1, 2])
+        end
+
+        it "passes when run third" do
+          @list << 3
+          expect(@list).to eq([1, 2, 3])
+        end
+      end
+      """
+
+    When I run `rspec order_dependent_spec.rb --order random:1`
+    Then the examples should all pass
+
+  Scenario: Registering a custom ordering
+    Given a file named "register_custom_ordering_spec.rb" with:
+      """ruby
+      RSpec.configure do |rspec|
+        rspec.register_ordering(:reverse) do |items|
+          items.reverse
+        end
+      end
+
+      describe "A group that must run in reverse order", :order => :reverse do
+        before(:all) { @list = [] }
+
+        it "passes when run second" do
+          @list << 2
+          expect(@list).to eq([1, 2])
+        end
+
+        it "passes when run first" do
+          @list << 1
+          expect(@list).to eq([1])
+        end
+      end
+      """
+    When I run `rspec register_custom_ordering_spec.rb`
+    Then the examples should all pass
+
+  Scenario: Using a custom global ordering
+    Given a file named "register_global_ordering_spec.rb" with:
+      """ruby
+      RSpec.configure do |rspec|
+        rspec.register_ordering(:global) do |items|
+          items.reverse
+        end
+      end
+
+      describe "A group without :order metadata" do
+        before(:all) { @list = [] }
+
+        it "passes when run second" do
+          @list << 2
+          expect(@list).to eq([1, 2])
+        end
+
+        it "passes when run first" do
+          @list << 1
+          expect(@list).to eq([1])
+        end
+      end
+      """
+    When I run `rspec register_global_ordering_spec.rb`
+    Then the examples should all pass
+

data/features/configuration/profile.feature

@@ -18,56 +18,56 @@ Feature: Profile examples
       describe "something" do
         it "sleeps for 0.1 seconds (example 1)" do
           sleep 0.1
-          1.should == 1
+          expect(1).to eq(1)
         end
 
         it "sleeps for 0 seconds (example 2)" do
-          2.should == 2
+          expect(2).to eq(2)
         end
 
         it "sleeps for 0.15 seconds (example 3)" do
           sleep 0.15
-          3.should == 3
+          expect(3).to eq(3)
         end
 
         it "sleeps for 0.05 seconds (example 4)" do
           sleep 0.05
-          4.should == 4
+          expect(4).to eq(4)
         end
 
         it "sleeps for 0.05 seconds (example 5)" do
           sleep 0.05
-          5.should == 5
+          expect(5).to eq(5)
         end
 
         it "sleeps for 0.05 seconds (example 6)" do
           sleep 0.05
-          6.should == 6
+          expect(6).to eq(6)
         end
 
         it "sleeps for 0.05 seconds (example 7)" do
           sleep 0.05
-          7.should == 7
+          expect(7).to eq(7)
         end
 
         it "sleeps for 0.05 seconds (example 8)" do
           sleep 0.05
-          8.should == 8
+          expect(8).to eq(8)
         end
 
         it "sleeps for 0.05 seconds (example 9)" do
           sleep 0.05
-          9.should == 9
+          expect(9).to eq(9)
         end
 
         it "sleeps for 0.05 seconds (example 10)" do
           sleep 0.05
-          10.should == 10
+          expect(10).to eq(10)
         end
 
         it "sleeps for 0.05 seconds (example 11)" do
           sleep 0.05
-          11.should == 11
+          expect(11).to eq(11)
         end
       end
       """
@@ -186,7 +186,7 @@ Feature: Profile examples
       describe "something" do
         it "sleeps for 0.1 seconds (example 1)" do
           sleep 0.1
-          1.should == 1
+          expect(1).to eq(1)
         end
 
         it "fails" do
@@ -207,7 +207,7 @@ Feature: Profile examples
       describe "something" do
         it "sleeps for 0.1 seconds (example 1)" do
           sleep 0.1
-          1.should == 1
+          expect(1).to eq(1)
         end
 
         it "fails" do

data/features/configuration/read_options_from_file.feature

@@ -19,16 +19,16 @@ Feature: read command line configuration options from files
       """
     And a file named "spec/example_spec.rb" with:
       """ruby
-      describe "color" do
+      describe "color_enabled" do
         context "when set with RSpec.configure" do
           before do
             # color is disabled for non-tty output, so stub the output stream
             # to say it is tty, even though we're running this with cucumber
-            RSpec.configuration.output_stream.stub(:tty?) { true }
+            allow(RSpec.configuration.output_stream).to receive(:tty?) { true }
           end
 
           it "is true" do
-            RSpec.configuration.should be_color_enabled
+            expect(RSpec.configuration).to be_color_enabled
           end
         end
       end
@@ -45,8 +45,8 @@ Feature: read command line configuration options from files
       """ruby
       describe "formatter set in custom options file" do
         it "sets formatter" do
-          RSpec.configuration.formatters.first.
-            should be_a(RSpec::Core::Formatters::DocumentationFormatter)
+          expect(RSpec.configuration.formatters.first).
+            to be_a(RSpec::Core::Formatters::DocumentationFormatter)
         end
       end
       """
@@ -66,7 +66,7 @@ Feature: read command line configuration options from files
       """ruby
       describe "custom options file" do
         it "causes .rspec to be ignored" do
-          RSpec.configuration.color.should be_falsey
+          expect(RSpec.configuration.color_enabled).to be_falsey
         end
       end
       """
@@ -82,7 +82,7 @@ Feature: read command line configuration options from files
       """ruby
       describe "formatter" do
         it "is set to documentation" do
-          RSpec.configuration.formatters.first.should be_an(RSpec::Core::Formatters::DocumentationFormatter)
+          expect(RSpec.configuration.formatters.first).to be_an(RSpec::Core::Formatters::DocumentationFormatter)
         end
       end
       """

data/features/example_groups/basic_structure.feature

@@ -23,7 +23,7 @@ Feature: basic structure (describe/it)
       end
     end
     """
-    When I run `rspec sample_spec.rb -f doc`
+    When I run `rspec sample_spec.rb -fn`
     Then the output should contain:
       """
       something

data/features/example_groups/shared_context.feature

@@ -28,19 +28,19 @@ Feature: shared context
         include_context "shared stuff"
 
         it "has access to methods defined in shared context" do
-          shared_method.should eq("it works")
+          expect(shared_method).to eq("it works")
         end
 
         it "has access to methods defined with let in shared context" do
-          shared_let['arbitrary'].should eq('object')
+          expect(shared_let['arbitrary']).to eq('object')
         end
 
         it "runs the before hooks defined in the shared context" do
-          @some_var.should be(:some_value)
+          expect(@some_var).to be(:some_value)
         end
 
         it "accesses the subject defined in the shared context" do
-          subject.should eq('this is the subject')
+          expect(subject).to eq('this is the subject')
         end
       end
       """
@@ -54,19 +54,19 @@ Feature: shared context
 
       describe "group that includes a shared context using metadata", :a => :b do
         it "has access to methods defined in shared context" do
-          shared_method.should eq("it works")
+          expect(shared_method).to eq("it works")
         end
 
         it "has access to methods defined with let in shared context" do
-          shared_let['arbitrary'].should eq('object')
+          expect(shared_let['arbitrary']).to eq('object')
         end
 
         it "runs the before hooks defined in the shared context" do
-          @some_var.should be(:some_value)
+          expect(@some_var).to be(:some_value)
         end
 
         it "accesses the subject defined in the shared context" do
-          subject.should eq('this is the subject')
+          expect(subject).to eq('this is the subject')
         end
       end
       """

data/features/example_groups/shared_examples.feature

@@ -46,20 +46,20 @@ Feature: shared examples
 
         context "initialized with 3 items" do
           it "says it has three items" do
-            collection.size.should eq(3)
+            expect(collection.size).to eq(3)
           end
         end
 
         describe "#include?" do
           context "with an an item that is in the collection" do
             it "returns true" do
-              collection.include?(7).should be_truthy
+              expect(collection.include?(7)).to be_truthy
             end
           end
 
           context "with an an item that is not in the collection" do
             it "returns false" do
-              collection.include?(9).should be_falsey
+              expect(collection.include?(9)).to be_falsey
             end
           end
         end
@@ -146,7 +146,7 @@ Feature: shared examples
     shared_examples "a measurable object" do |measurement, measurement_methods|
       measurement_methods.each do |measurement_method|
         it "should return #{measurement} from ##{measurement_method}" do
-          subject.send(measurement_method).should == measurement
+          expect(subject.send(measurement_method)).to eq(measurement)
         end
       end
     end
@@ -185,7 +185,7 @@ Feature: shared examples
 
       shared_examples 'sortability' do
         it 'responds to <=>' do
-          sortable.should respond_to(:<=>)
+          expect(sortable).to respond_to(:<=>)
         end
       end
 
@@ -282,13 +282,5 @@ Feature: shared examples
     When I run `rspec isolated_shared_examples_spec.rb`
     Then the output should contain:
       """
-      1 example, 0 failures
-      """
-    But the output should contain:
-      """
-      Accessing shared_examples defined across contexts is deprecated
-      """
-    And the output should contain:
-      """
-      isolated_shared_examples_spec.rb:9
+      Could not find shared examples \"shared examples are isolated\"
       """

data/features/expectation_framework_integration/configure_expectation_framework.feature

@@ -4,16 +4,16 @@ Feature: configure expectation framework
   desired outcomes. You can also configure RSpec to use:
 
   * rspec/expectations (explicitly)
-  * stdlib assertions **DEPRECATED: Use test/unit or minitest explicitly**
-  * test/unit assertions
-  * minitest assertions
-  * any combination of the above libraries
+  * stdlib assertions
+    * test/unit assertions in ruby 1.8
+    * minitest assertions in ruby 1.9
+  * rspec/expectations _and_ stlib assertions
 
-  Note that when you do not use rspec-expectations, you must explicitly provide
-  a description to every example.  You cannot rely on the generated descriptions
-  provided by rspec-expectations.
+  Note that when you do not use rspec-expectations, you must explicitly
+  provide a description to every example.  You cannot rely on the generated
+  descriptions provided by rspec-expectations.
 
-  Scenario: Default configuration uses rspec-expectations
+  Scenario: rspec-expectations can be used by default if nothing is configured
     Given a file named "example_spec.rb" with:
       """ruby
       RSpec::Matchers.define :be_a_multiple_of do |factor|
@@ -23,13 +23,13 @@ Feature: configure expectation framework
       end
 
       describe 6 do
-        it { is_expected.to be_a_multiple_of 3 }
+        it { should be_a_multiple_of(3) }
       end
       """
     When I run `rspec example_spec.rb`
     Then the examples should all pass
 
-  Scenario: Configure rspec-expectations (explicitly)
+  Scenario: configure rspec-expectations (explicitly)
     Given a file named "example_spec.rb" with:
       """ruby
       RSpec.configure do |config|
@@ -38,15 +38,14 @@ Feature: configure expectation framework
 
       describe 5 do
         it "is greater than 4" do
-          5.should be > 4
+          expect(5).to be > 4
         end
       end
       """
     When I run `rspec example_spec.rb`
     Then the examples should all pass
 
-  @deprecated
-  Scenario: Configure 'stdlib' assertions
+  Scenario: configure test/unit assertions (passing examples)
     Given a file named "example_spec.rb" with:
       """ruby
       RSpec.configure do |config|
@@ -59,138 +58,44 @@ Feature: configure expectation framework
         end
 
         specify { assert 5 < 6 }
-
-        it "is greater than 6 (no it isn't!)" do
-          assert 5 > 6, "errantly expected 5 to be greater than 5"
-        end
-      end
-      """
-    When I run `rspec example_spec.rb`
-    Then the output should match:
-      """
-           (Test::Unit::AssertionFailedError|Mini(T|t)est::Assertion):
-             errantly expected 5 to be greater than 5
-      """
-    And  the output should contain "3 examples, 1 failure"
-    And  the output should contain ":stdlib is deprecated. Use :test_unit or :minitest instead"
-
-  Scenario: Configure test/unit assertions
-    Given a file named "example_spec.rb" with:
-      """ruby
-      RSpec.configure do |config|
-        config.expect_with :test_unit
-      end
-
-      RSpec.describe [1] do
-        it "is equal to [1]" do
-          assert_equal [1], [1], "expected [1] to equal [1]"
-        end
-
-        specify { assert_not_equal [1], [] }
-
-        it "is equal to [2] (intentional failure)" do
-          assert [1] == [2], "errantly expected [2] to equal [1]"
-        end
       end
       """
     When I run `rspec example_spec.rb`
-    Then the output should match:
-      """
-           (Test::Unit::AssertionFailedError|Mini(T|t)est::Assertion):
-             errantly expected \[2\] to equal \[1\]
-      """
-    And  the output should contain "3 examples, 1 failure"
+    Then the output should contain "2 examples, 0 failures"
 
-  Scenario: Configure minitest assertions
+  Scenario: configure test/unit assertions (failing examples)
     Given a file named "example_spec.rb" with:
       """ruby
       RSpec.configure do |config|
-        config.expect_with :minitest
-      end
-
-      RSpec.describe "Object identity" do
-        it "the an object is the same as itself" do
-          x = [1]
-          assert_same x, x, "expected x to be the same x"
-        end
-
-        specify { refute_same [1], [1] }
-
-        it "is empty (intentional failure)" do
-          assert_empty [1], "errantly expected [1] to be empty"
-        end
-      end
-      """
-    When I run `rspec -b example_spec.rb`
-    Then the output should match:
-      """
-           MiniT|test::Assertion:
-             errantly expected \[1\] to be empty
-      """
-    And  the output should contain "3 examples, 1 failure"
-    And  the output should not contain "Warning: you should require 'minitest/autorun' instead."
-
-  Scenario: Configure rspec/expectations AND test/unit assertions
-    Given a file named "example_spec.rb" with:
-      """ruby
-      RSpec.configure do |config|
-        config.expect_with :rspec, :test_unit
-      end
-
-      RSpec.describe [1] do
-        it "is equal to [1]" do
-          assert_equal [1], [1], "expected [1] to equal [1]"
-        end
-
-        it "matches array [1]" do
-          is_expected.to match_array([1])
-        end
-      end
-      """
-    When I run `rspec example_spec.rb`
-    Then the examples should all pass
-
-  Scenario: Configure rspec/expecations AND minitest assertions
-    Given a file named "example_spec.rb" with:
-      """ruby
-      RSpec.configure do |config|
-        config.expect_with :rspec, :minitest
+        config.expect_with :stdlib
       end
 
-      RSpec.describe "Object identity" do
-        it "two arrays are not the same object" do
-          refute_same [1], [1]
+      describe 5 do
+        it "is greater than 6 (no it isn't!)" do
+          assert 5 > 6, "errantly expected 5 to be greater than 5"
         end
 
-        it "an array is itself" do
-          array = [1]
-          expect(array).to be array
-        end
+        specify { assert 5 > 6 }
       end
       """
     When I run `rspec example_spec.rb`
-    Then the examples should all pass
+    Then the output should contain "2 examples, 2 failures"
 
-  Scenario: Configure test/unit and minitest assertions
+  Scenario: configure rspec/expecations AND test/unit assertions
     Given a file named "example_spec.rb" with:
       """ruby
       RSpec.configure do |config|
-        config.expect_with :test_unit, :minitest
+        config.expect_with :rspec, :stdlib
       end
 
-      RSpec.describe [1] do
-        it "is equal to [1]" do
-          assert_equal [1], [1], "expected [1] to equal [1]"
+      describe 5 do
+        it "is greater than 4" do
+          assert 5 > 4, "expected 5 to be greater than 4"
         end
 
-        specify { assert_not_equal [1], [] }
-
-        it "the an object is the same as itself" do
-          x = [1]
-          assert_same x, x, "expected x to be the same x"
+        it "is less than 6" do
+          expect(5).to be < 6
         end
-
-        specify { refute_same [1], [1] }
       end
       """
     When I run `rspec example_spec.rb`