ageweke-rspec 1.2.9

data/features/command_line/line_number_option.feature

@@ -0,0 +1,56 @@
+Feature: Spec and test together
+
+  As an RSpec user
+  I want to run one example identified by the line number
+  
+  Background:
+    Given a file named "example.rb" with:
+      """
+      describe "a group" do
+
+        it "has a first example" do
+
+        end
+        
+        it "has a second example" do
+
+        end
+        
+      end
+      """
+
+  Scenario: two examples - first example on declaration line
+    When I run "spec example.rb:3 --format nested"
+    Then the stdout should include "1 example, 0 failures"
+    And the stdout should include "has a first example"
+    But the stdout should not match "has a second example"
+
+  Scenario: two examples - first example from line inside declaration
+    When I run "spec example.rb:4 --format nested"
+    Then the stdout should include "1 example, 0 failures"
+    And the stdout should include "has a first example"
+    But the stdout should not match "has a second example"
+
+  Scenario: two examples - first example from line below declaration
+    When I run "spec example.rb:6 --format nested"
+    Then the stdout should include "1 example, 0 failures"
+    And the stdout should include "has a first example"
+    But the stdout should not match "has a second example"
+
+  Scenario: two examples - second example from line below declaration
+    When I run "spec example.rb:7 --format nested"
+    Then the stdout should include "1 example, 0 failures"
+    And the stdout should include "has a second example"
+    But the stdout should not match "has a first example"
+
+  Scenario: two examples - both examples from the group declaration
+    When I run "spec example.rb:1 --format nested"
+    Then the stdout should include "2 examples, 0 failures"
+    And the stdout should include "has a second example"
+    And the stdout should include "has a first example"
+
+  Scenario: two examples - both examples from above the first example declaration
+    When I run "spec example.rb:2 --format nested"
+    Then the stdout should include "2 examples, 0 failures"
+    And the stdout should include "has a second example"
+    And the stdout should include "has a first example"

data/features/command_line/line_number_option_with_example_with_no_name.feature

@@ -0,0 +1,22 @@
+Feature: Spec and test together
+
+  As an RSpec user
+  I want to run one example identified by the line number
+  
+  Background:
+    Given a file named "example.rb" with:
+      """
+      describe 9 do
+
+        it { should be > 8 }
+
+        it { should be < 10 }
+        
+      end
+      """
+
+  Scenario: two examples - first example on declaration line
+    When I run "spec example.rb:3 --format nested"
+    Then the stdout should include "1 example, 0 failures"
+    Then the stdout should include "should be > 8"
+    But the stdout should not match "should be < 10"

data/features/example_groups/define_example_attribute.feature

@@ -0,0 +1,41 @@
+Feature: Define example attribute
+
+  In order to streamline process
+  As an RSpec user
+  I want to easily define helper methods that act as a variable assignment
+  
+  It is fairly common to start with a local variable in one example, use the same
+  local variable in the next, and then extract the declaration of that variable
+  to before(:each). This requires converting the locals to instance variables.
+  
+  This feature streamlines the process by defining a helper method so you can extract
+  the duplication without having to change other references to the same variables
+  to @instance_variables.
+
+  Scenario: 
+    Given a file named "counter_spec.rb" with:
+    """
+    require 'spec/autorun'
+    
+    class Counter
+      def initialize
+        @count = 0
+      end
+      def count
+        @count += 1
+      end
+    end
+
+    describe Counter do
+      let(:counter) { Counter.new }
+      it "returns 1 the first time" do
+        counter.count.should == 1
+      end
+      it "returns 2 the second time because the counter itself is cached by the 'assign' method" do
+        counter.count
+        counter.count.should == 2
+      end
+    end
+    """
+    When I run "spec counter_spec.rb"
+    Then the stdout should include "2 examples, 0 failures"

data/features/example_groups/example_group_with_should_methods.feature

@@ -0,0 +1,29 @@
+Feature: Spec::ExampleGroup with should methods
+
+  As an RSpec adopter accustomed to classes and methods
+  I want to use should_* methods in an ExampleGroup
+  So that I use RSpec with classes and methods that look more like RSpec examples
+
+  Scenario Outline: Example Group class with should methods
+    Given a file named "example_group_with_should_methods.rb" with:
+    """
+    require 'spec/autorun'
+
+    class MySpec < Spec::ExampleGroup
+      def should_pass_with_should
+        1.should == 1
+      end
+
+      def should_fail_with_should
+        1.should == 2
+      end
+    end
+    """
+    When I run "<Command> example_group_with_should_methods.rb"
+    Then the exit code should be 256
+    And the stdout should include "2 examples, 1 failure"
+
+  Scenarios: Run with ruby and spec
+    | Command |
+    | ruby    |
+    | spec    |

data/features/example_groups/implicit_docstrings.feature

@@ -0,0 +1,59 @@
+Feature: implicit docstrings
+
+  As an RSpec user
+  I want examples to generate their own names
+  So that I can reduce duplication between example names and example code
+
+  Scenario Outline: run passing examples
+    Given a file named "implicit_docstrings_example.rb" with:
+    """
+    require 'spec/autorun'
+    describe "Examples with no docstrings generate their own:" do
+
+      specify { 3.should be < 5 }
+
+      specify { ["a"].should include("a") }
+
+      specify { [1,2,3].should respond_to(:size) }
+
+    end
+    """
+
+    When I run "<Command> implicit_docstrings_example.rb -fs"
+
+    Then the stdout should include /should be < 5/
+    And the stdout should include /should include "a"/
+    And the stdout should include /should respond to #size/
+
+  Scenarios: Run with ruby and spec
+    | Command |
+    | ruby    |
+    | spec    |
+
+  Scenario Outline: run failing examples
+    Given a file named "failing_implicit_docstrings_example.rb" with:
+    """
+    require 'spec/autorun'
+    describe "Failing examples with no descriptions" do
+
+      # description is auto-generated as "should equal(5)" based on the last #should
+      it do
+        3.should equal(2)
+        5.should equal(5)
+      end
+
+      it { 3.should be > 5 }
+
+      it { ["a"].should include("b") }
+
+      it { [1,2,3].should_not respond_to(:size) }
+
+    end
+    """
+
+    When I run "<Command> failing_implicit_docstrings_example.rb -fs"
+
+    Then the stdout should include /should equal 2/
+    And the stdout should include /should be > 5/
+    And the stdout should include /should include "b"/
+    And the stdout should include /should not respond to #size/

data/features/example_groups/nested_groups.feature

@@ -0,0 +1,32 @@
+Feature: Nested example groups
+
+  As an RSpec user
+  I want to nest examples groups
+  So that I can better organize my examples
+
+  Scenario Outline: Nested example groups
+    Given a file named "nested_example_groups.rb" with:
+    """
+    require 'spec/autorun'
+
+    describe "Some Object" do
+      describe "with some more context" do
+        it "should do this" do
+          true.should be_true
+        end
+      end
+      describe "with some other context" do
+        it "should do that" do
+          false.should be_false
+        end
+      end
+    end
+    """
+    When I run "<Command> nested_example_groups.rb -fs"
+    Then the stdout should include /Some Object with some more context/
+    And the stdout should include /Some Object with some other context/
+
+  Scenarios: Run with ruby and spec
+    | Command |
+    | ruby    |
+    | spec    |

data/features/expectations/customized_message.feature

@@ -0,0 +1,54 @@
+Feature: customized message
+
+  In order to get the feedback I want
+  As an RSpec user
+  I want to customize the failure message per example
+  
+  Scenario: one additional method
+    Given a file named "node_spec.rb.rb" with:
+      """
+      class Node
+        def initialize(state=:waiting)
+          @state = state
+        end
+        def state
+          @state
+        end
+        def waiting?
+          @state == :waiting
+        end
+        def started?
+          @state == :started
+        end
+        def start
+          @state = :started
+        end
+      end
+      
+      describe "a new Node" do
+        it "should be waiting" do
+          node = Node.new(:started) #start w/ started to trigger failure
+          node.should be_waiting, "node.state: #{node.state} (first example)"
+        end
+        
+        it "should not be started" do
+          node = Node.new(:started) #start w/ started to trigger failure
+          node.should_not be_started, "node.state: #{node.state} (second example)"
+        end
+      end
+      
+      describe "node.start" do
+        it "should change the state" do
+          node = Node.new(:started) #start w/ started to trigger failure
+          lambda {node.start}.should change{node.state}, "expected a change"
+        end
+      end
+      
+      """
+    When I run "spec node_spec.rb.rb --format specdoc"
+    Then the stdout should include "3 examples, 3 failures"
+    And  the stdout should not match "to return true, got false"
+    And  the stdout should not match "to return false, got true"
+    And  the stdout should include "node.state: started (first example)"
+    And  the stdout should include "node.state: started (second example)"
+    And  the stdout should include "expected a change"

data/features/expectations/expect_change.feature

@@ -0,0 +1,65 @@
+Feature: expect change
+
+  Expect some code (wrapped in a proc) to change the state of some object.
+  
+  Scenario: expecting change
+    Given a file named "expect_change.rb" with:
+      """
+      class Counter
+        class << self
+          def increment
+            @count ||= 0
+            @count += 1
+          end
+          
+          def count
+            @count ||= 0
+          end
+        end
+      end
+      
+      describe Counter, "#increment" do
+        it "should increment the count" do
+          expect{Counter.increment}.to change{Counter.count}.from(0).to(1)
+        end
+
+        # deliberate failure
+        it "should increment the count by 2" do
+          expect{Counter.increment}.to change{Counter.count}.by(2)
+        end
+      end
+      """
+    When I run "spec expect_change.rb"
+    Then the stdout should include "2 examples, 1 failure"
+    Then the stdout should include "should have been changed by 2, but was changed by 1"
+
+  Scenario: expecting no change
+    Given a file named "expect_no_change.rb" with:
+      """
+      class Counter
+        class << self
+          def increment
+            @count ||= 0
+            @count += 1
+          end
+          
+          def count
+            @count ||= 0
+          end
+        end
+      end
+
+      describe Counter, "#increment" do
+        it "should not increment the count by 2" do
+          expect{Counter.increment}.to_not change{Counter.count}.from(0).to(2)
+        end
+
+        # deliberate failure
+        it "should not increment the count by 1" do
+          expect{Counter.increment}.to_not change{Counter.count}.by(1)
+        end
+      end
+      """
+    When I run "spec expect_no_change.rb"
+    Then the stdout should include "2 examples, 1 failure"
+    Then the stdout should include "should not have changed, but did change from 1 to 2"

data/features/expectations/expect_error.feature

@@ -0,0 +1,44 @@
+Feature: expect error
+
+  Expect a proc to change the state of some object.
+  
+  Scenario: expect error
+    Given a file named "expect_error.rb" with:
+      """
+      describe Object, "#non_existent_message" do
+        it "should raise" do
+          expect{Object.non_existent_message}.to raise_error(NameError)
+        end
+      end
+
+      #deliberate failure
+      describe Object, "#public_instance_methods" do
+        it "should raise" do
+          expect{Object.public_instance_methods}.to raise_error(NameError)
+        end
+      end
+      """
+    When I run "spec expect_error.rb"
+    Then the stdout should include "2 examples, 1 failure"
+    Then the stdout should include "expected NameError but nothing was raised"
+
+  Scenario: expect no error
+    Given a file named "expect_no_error.rb" with:
+      """
+      describe Object, "#public_instance_methods" do
+        it "should not raise" do
+          expect{Object.public_instance_methods}.to_not raise_error(NameError)
+        end
+      end
+
+      #deliberate failure
+      describe Object, "#non_existent_message" do
+        it "should not raise" do
+          expect{Object.non_existent_message}.to_not raise_error(NameError)
+        end
+      end
+      """
+    When I run "spec expect_no_error.rb"
+    Then the stdout should include "2 examples, 1 failure"
+    Then the stdout should include "undefined method `non_existent_message'"
+

data/features/extensions/custom_example_group.feature

@@ -0,0 +1,19 @@
+Feature: custom example group
+
+  Scenario: simple custom example group
+    Given a file named "custom_example_group_spec.rb" with:
+      """
+      class CustomGroup < Spec::ExampleGroup
+      end
+
+      Spec::Example::ExampleGroupFactory.default(CustomGroup)
+
+      describe "a custom group set as the default" do
+        it "becomes the default base class for example groups" do
+          CustomGroup.should === self
+        end
+      end
+      """
+    When I run "spec custom_example_group_spec.rb"
+    Then the stdout should include "1 example, 0 failures"
+

data/features/formatters/custom_formatter.feature

@@ -0,0 +1,30 @@
+Feature: custom formatters
+
+  In order to format output/reporting to my particular needs
+  As an RSpec user
+  I want to create my own custom output formatters
+
+  Scenario: specdoc format
+    Given a file named "custom_formatter.rb" with:
+      """
+      require 'spec/runner/formatter/base_formatter'
+      class CustomFormatter < Spec::Runner::Formatter::BaseFormatter
+        def initialize(options, output)
+          @output = output
+        end
+        def example_started(proxy)
+          @output << "example: " << proxy.description
+        end
+      end
+      """
+    And a file named "simple_example_spec.rb" with:
+      """
+      describe "my group" do
+        specify "my example" do
+        end
+      end
+      """
+
+    When I run "spec simple_example_spec.rb --require custom_formatter.rb --format CustomFormatter"
+    Then the exit code should be 0
+    And the stdout should include "example: my example"