rspec-core 2.0.0.beta.22 → 2.0.0.rc

data/features/configuration/custom_settings.feature

@@ -1,10 +1,8 @@
 Feature: custom settings
 
-  In order to seamlessly provide users more configuration settings
-  As an RSpec extenstion-library author
-  I want to define new settings on the RSpec.configuration object
+  Extensions like rspec-rails can add their own configuration settings.
 
-  Scenario: simple setting
+  Scenario: simple setting (with defaults)
     Given a file named "additional_setting_spec.rb" with:
       """
       RSpec.configure do |c|

data/features/configuration/fail_fast.feature

@@ -0,0 +1,77 @@
+Feature: fail fast
+
+  Use the fail_fast option to tell RSpec to abort the run on first failure.
+
+    RSpec.configure {|c| c.fail_fast = true}
+
+  Background:
+    Given a file named "spec/spec_helper.rb" with:
+      """
+      RSpec.configure {|c| c.fail_fast = true}
+      """
+
+  Scenario: fail_fast with no failures (runs all examples)
+    Given a file named "spec/example_spec.rb" with:
+      """
+      describe "something" do
+        it "passes" do
+        end
+
+        it "passes too" do
+        end
+      end
+      """
+    When I run "rspec spec/example_spec.rb"
+    Then the output should contain "2 examples, 0 failures"
+
+  Scenario: fail_fast with first example failing (only runs the one example)
+    Given a file named "spec/example_spec.rb" with:
+      """
+      require "spec_helper"
+      describe "something" do
+        it "fails" do
+          fail
+        end
+
+        it "passes" do
+        end
+      end
+      """
+    When I run "rspec spec/example_spec.rb -fd"
+    Then the output should contain "1 example, 1 failure"
+
+  Scenario: fail_fast with multiple files, second example failing (only runs the first two examples)
+    Given a file named "spec/example_1_spec.rb" with:
+      """
+      require "spec_helper"
+      describe "something" do
+        it "passes" do
+        end
+
+        it "fails" do
+          fail
+        end
+      end
+
+      describe "something else" do
+        it "fails" do
+          fail
+        end
+      end
+      """
+    And a file named "spec/example_2_spec.rb" with:
+      """
+      require "spec_helper"
+      describe "something" do
+        it "passes" do
+        end
+      end
+
+      describe "something else" do
+        it "fails" do
+          fail
+        end
+      end
+      """
+    When I run "rspec spec"
+    Then the output should contain "2 examples, 1 failure"

data/features/configuration/read_options_from_file.feature

@@ -1,7 +1,7 @@
 Feature: read command line configuration options from files
 
-  RSpec will read command line configuration options from files in
-  two different locations:
+  RSpec reads command line configuration options from files in two different
+  locations:
   
     Local:  "./.rspec" (i.e. in the project's root directory)
     Global: "~/.rspec" (i.e. in the user's home directory)
@@ -9,9 +9,6 @@ Feature: read command line configuration options from files
   Options declared in the local file override those in the global file, while
   those declared in RSpec.configure will override any ".rspec" file.
   
-  NOTE: For backwards compatibility with rspec-1, you can write command line
-  options in a "spec/spec.opts" file and it will be loaded automatically.
-            
   Scenario: color set in .rspec
     Given a file named ".rspec" with:
       """

data/features/example_groups/basic_structure.feature

@@ -0,0 +1,54 @@
+Feature: basic structure
+
+  RSpec provides a DSL for creating executable examples of how code is expected
+  to behave, organized in groups. It uses the words "describe" and "it" so we can
+  express concepts like a conversation:
+
+    "Describe an account when it is first opened."
+    "It has a balance of zero."
+
+  Use the describe() method to declare an example group. This defines a
+  subclass of RSpec's ExampleGroup class. Within a group, you can declare
+  nested groups using the describe() or context() methods.
+
+  Use the it() method to declare an example. This, effectively, defines a
+  method that is run in an instance of the group in which it is declared.
+
+  Scenario: one group, one example
+    Given a file named "sample_spec.rb" with:
+    """
+    describe "something" do
+      it "does something" do
+      end
+    end
+    """
+    When I run "rspec sample_spec.rb -fn"
+    Then the output should contain:
+      """
+      something
+        does something
+      """
+
+  Scenario: nested example groups (using context)
+    Given a file named "nested_example_groups_spec.rb" with:
+    """
+    describe "something" do
+      context "in one context" do
+        it "does one thing" do
+        end
+      end
+      context "in another context" do
+        it "does another thing" do
+        end
+      end
+    end
+    """
+    When I run "rspec nested_example_groups_spec.rb -fdoc"
+    Then the output should contain:
+      """
+      something
+        in one context
+          does one thing
+        in another context
+          does another thing
+      """

data/features/example_groups/shared_example_group.feature

@@ -1,64 +1,76 @@
 Feature: Shared example group
 
-  As an RSpec user
-  I want to share my examples
-  In order to reduce duplication in my specs
+  Shared example groups let you describe behaviour of types or modules. When
+  declared, a shared group's content is stored. It is only realized in the
+  context of another example group, which provides any context the shared group
+  needs to run.
 
-  Scenario: Using a shared example group
-    Given a file named "shared_example_group_spec.rb" with:
+  A shared group is included in another group using the it_behaves_like() or
+  it_should_behave_like() methods.
+
+  Scenario: shared example group applied to two groups
+    Given a file named "collection_spec.rb" with:
     """
     require "set"
 
-    shared_examples_for "a collection object" do
-      before(:each) do
-        @instance = described_class.new([7, 2, 4])
-      end
+    shared_examples_for "a collection" do
+      let(:collection) { described_class.new([7, 2, 4]) }
 
       context "initialized with 3 items" do
-        it "has three items" do
-          @instance.size.should == 3
+        it "says it has three items" do
+          collection.size.should eq(3)
         end
       end
 
       describe "#include?" do
-        context "with an an item in the collection" do
+        context "with an an item that is in the collection" do
           it "returns true" do
-            @instance.include?(7).should be_true
+            collection.include?(7).should be_true
+          end
+        end
+
+        context "with an an item that is not in the collection" do
+          it "returns false" do
+            collection.include?(9).should be_false
           end
         end
       end
     end
 
     describe Array do
-      it_should_behave_like "a collection object"
+      it_behaves_like "a collection"
     end
 
     describe Set do
-      it_should_behave_like "a collection object"
+      it_behaves_like "a collection"
     end
     """
-    When I run "rspec shared_example_group_spec.rb --format documentation"
-    Then the output should contain "4 examples, 0 failures"
+    When I run "rspec collection_spec.rb --format documentation"
+    Then the output should contain "6 examples, 0 failures"
     And the output should contain:
       """
       Array
-        it should behave like a collection object
+        behaves like a collection
           initialized with 3 items
-            has three items
+            says it has three items
           #include?
-            with an an item in the collection
+            with an an item that is in the collection
               returns true
+            with an an item that is not in the collection
+              returns false
 
       Set
-        it should behave like a collection object
+        behaves like a collection
           initialized with 3 items
-            has three items
+            says it has three items
           #include?
-            with an an item in the collection
+            with an an item that is in the collection
               returns true
+            with an an item that is not in the collection
+              returns false
       """
 
-  Scenario: Using a shared example group with a block
+  Scenario: Providing context to a shared group using a block
     Given a file named "shared_example_group_spec.rb" with:
     """
     require "set"
@@ -100,7 +112,6 @@ Feature: Shared example group
             adds objects to the end of the collection
       """
 
-  @wip
   Scenario: Passing parameters to a shared example group
     Given a file named "shared_example_group_params_spec.rb" with:
     """
@@ -145,7 +156,7 @@ Feature: Shared example group
       end
 
       shared_examples_for 'sortability' do
-        it 'responds to <==>' do
+        it 'responds to <=>' do
           sortable.should respond_to(:<=>)
         end
       end
@@ -162,5 +173,5 @@ Feature: Shared example group
       """
       String
         has behavior: sortability
-          responds to <==>
+          responds to <=>
       """

data/features/filtering/exclusion_filters.feature

@@ -1,9 +1,13 @@
 Feature: exclusion filters
+
+  You can exclude examples from a run by declaring an exclusion filter and
+  then tagging examples, or entire groups, with that filter.
   
-  Scenario: exclude one example
+  Scenario: exclude an example
     Given a file named "spec/sample_spec.rb" with:
       """
       RSpec.configure do |c|
+        # declare an exclusion filter
         c.filter_run_excluding :broken => true
       end
 
@@ -11,6 +15,7 @@ Feature: exclusion filters
         it "does one thing" do
         end
 
+        # tag example for exclusion by adding metadata
         it "does another thing", :broken => true do
         end
       end
@@ -19,7 +24,7 @@ Feature: exclusion filters
     Then the output should contain "does one thing"
     And the output should not contain "does another thing"
 
-  Scenario: exclude one group
+  Scenario: exclude a group
     Given a file named "spec/sample_spec.rb" with:
       """
       RSpec.configure do |c|
@@ -44,7 +49,7 @@ Feature: exclusion filters
     And  the output should not contain "group 1 example 1"
     And  the output should not contain "group 1 example 2"
   
-  Scenario: exclude all groups
+  Scenario: exclude multiple groups
     Given a file named "spec/sample_spec.rb" with:
       """
       RSpec.configure do |c|
@@ -76,4 +81,35 @@ Feature: exclusion filters
     Then the output should contain "No examples were matched. Perhaps {:broken=>true} is excluding everything?"
     And  the output should contain "0 examples, 0 failures"
     And  the output should not contain "group 1"
-    And  the output should not contain "group 2"
+    And  the output should not contain "group 2"
+
+  Scenario: before/after(:all) hooks in excluded example group are not run
+    Given a file named "spec/before_after_all_exclusion_filter_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        c.filter_run_excluding :broken => true
+      end
+
+      describe "group 1" do
+        before(:all) { puts "before all in included group" }
+        after(:all)  { puts "after all in included group"  }
+
+        it "group 1 example" do
+        end
+      end
+
+      describe "group 2", :broken => true do
+        before(:all) { puts "before all in excluded group" }
+        after(:all)  { puts "after all in excluded group"  }
+
+        context "context 1" do
+          it "group 2 context 1 example 1" do
+          end
+        end
+      end
+      """
+    When I run "rspec ./spec/before_after_all_exclusion_filter_spec.rb"
+    Then the output should contain "before all in included group"
+     And the output should contain "after all in included group"
+     And the output should not contain "before all in excluded group"
+     And the output should not contain "after all in excluded group"

data/features/filtering/inclusion_filters.feature

@@ -1,11 +1,22 @@
 Feature: inclusion filters
-  
-  Scenario: focus on one example
-    Given a file named "spec/sample_spec.rb" with:
+
+  You can restrict which examples are run by declaring an inclusion filter. The
+  most common use case is to focus on a subset of examples as you're focused on
+  a particular problem.
+
+  Background:
+    Given a file named "spec/spec_helper.rb" with:
       """
       RSpec.configure do |c|
+        # filter_run is short-form alias for filter_run_including
         c.filter_run :focus => true
       end
+      """
+
+  Scenario: focus on an example
+    Given a file named "spec/sample_spec.rb" with:
+      """
+      require "spec_helper"
 
       describe "something" do
         it "does one thing" do
@@ -15,16 +26,14 @@ Feature: inclusion filters
         end
       end
       """
-    When I run "rspec ./spec/sample_spec.rb --format doc"
+    When I run "rspec spec/sample_spec.rb --format doc"
     Then the output should contain "does another thing"
     And the output should not contain "does one thing"
 
-  Scenario: focus on one group
+  Scenario: focus on a group
     Given a file named "spec/sample_spec.rb" with:
       """
-      RSpec.configure do |c|
-        c.filter_run :focus => true
-      end
+      require "spec_helper"
 
       describe "group 1", :focus => true do
         it "group 1 example 1" do
@@ -39,36 +48,36 @@ Feature: inclusion filters
         end
       end
       """
-    When I run "rspec ./spec/sample_spec.rb --format doc"
+    When I run "rspec spec/sample_spec.rb --format doc"
     Then the output should contain "group 1 example 1"
     And  the output should contain "group 1 example 2"
     And  the output should not contain "group 2 example 1"
 
-  Scenario: no examples match filter
-    Given a file named "spec/sample_spec.rb" with:
+  Scenario: before/after(:all) hooks in unmatched example group are not run
+    Given a file named "spec/before_after_all_inclusion_filter_spec.rb" with:
       """
-      RSpec.configure do |c|
-        c.filter_run :focus => true
-        c.run_all_when_everything_filtered = true
-      end
+      require "spec_helper"
 
-      describe "group 1" do
-        it "group 1 example 1" do
-        end
+      describe "group 1", :focus => true do
+        before(:all) { puts "before all in focused group" }
+        after(:all)  { puts "after all in focused group"  }
 
-        it "group 1 example 2" do
+        it "group 1 example" do
         end
       end
 
       describe "group 2" do
-        it "group 2 example 1" do
+        before(:all) { puts "before all in unfocused group" }
+        after(:all)  { puts "after all in unfocused group"  }
+
+        context "context 1" do
+          it "group 2 context 1 example 1" do
+          end
         end
       end
       """
-    When I run "rspec ./spec/sample_spec.rb --format doc"
-    Then the output should contain "No examples were matched by {:focus=>true}, running all"
-    And  the output should contain "group 1 example 1"
-    And  the output should contain "group 1 example 2"
-    And  the output should contain "group 2 example 1"
-    And  the output should contain "3 examples, 0 failures"
-
+    When I run "rspec ./spec/before_after_all_inclusion_filter_spec.rb"
+    Then the output should contain "before all in focused group"
+     And the output should contain "after all in focused group"
+     And the output should not contain "before all in unfocused group"
+     And the output should not contain "after all in unfocused group"