rspec 1.0.0 → 1.3.1

data/features/interop/examples_and_tests_together.feature

@@ -0,0 +1,84 @@
+Feature: Spec and test together
+
+  As an RSpec adopter with existing Test::Unit tests
+  I want to run a few specs alongside my existing Test::Unit tests
+  So that I can experience a smooth, gradual migration path
+
+  Scenario Outline: Run specs and tests together
+    Given a file named "spec_and_test_together.rb" with:
+    """
+    require 'spec/autorun'
+    require 'spec/test/unit'
+
+    describe "An Example" do
+      it "should pass with assert" do
+        assert true
+      end
+
+      it "should fail with assert" do
+        assert false
+      end
+
+      it "should pass with should" do
+        1.should == 1
+      end
+
+      it "should fail with should" do
+        1.should == 2
+      end
+    end
+
+    class ATest < Test::Unit::TestCase
+      def test_should_pass_with_assert
+        assert true
+      end
+
+      def test_should_fail_with_assert
+        assert false
+      end
+
+      def test_should_pass_with_should
+        1.should == 1
+      end
+
+      def test_should_fail_with_should
+        1.should == 2
+      end
+
+      def setup
+        @from_setup ||= 3
+        @from_setup += 1
+      end
+
+      def test_should_fail_with_setup_method_variable
+        @from_setup.should == 40
+      end
+
+      before do
+        @from_before = @from_setup + 1
+      end
+
+      def test_should_fail_with_before_block_variable
+        @from_before.should == 50
+      end
+      
+      define_method :"test: should run with strange name" do
+        assert true
+      end
+    end
+    """
+
+    When I run "<Command> spec_and_test_together.rb -fs"
+
+    Then the exit code should be 256
+    And the stdout should include "ATest"
+    And the stdout should include "Test::Unit::AssertionFailedError in 'An Example should fail with assert'"
+    And the stdout should include "'An Example should fail with should' FAILED"
+    And the stdout should include "11 examples, 6 failures"
+    And the stdout should include /expected: 40,\s*got: 4/m
+    And the stdout should include /expected: 50,\s*got: 5/m
+
+  Scenarios: run with ruby and spec
+    | Command |
+    | ruby    |
+    | spec    |

data/features/interop/rspec_output.feature

@@ -0,0 +1,25 @@
+Feature: spec output
+
+  When running in interop mode with test/unit, RSpec will output
+  the RSpec summary, but not the test/unit summary.
+
+  Scenario Outline: Interop mode with test/unit
+    Given a file named "simple_spec.rb" with:
+    """
+    require 'spec/autorun'
+
+    describe "Running an Example" do
+      it "should not output twice" do
+        true.should be_true
+      end
+    end
+    """
+    When I run "<Command> simple_spec.rb"
+    Then the exit code should be 0
+    And the stdout should not match /\d+ tests, \d+ assertions, \d+ failures, \d+ errors/m
+    And the stdout should include "1 example, 0 failures"
+
+  Scenarios: Run with ruby and CommandLine object
+    | Command     |
+    | ruby        |
+    | cmdline.rb  |

data/features/interop/test_but_not_test_unit.feature

@@ -0,0 +1,26 @@
+Feature: Test is defined, but not Test::Unit
+
+  As an RSpec user who has my own library named Test (but not Test::Unit)
+  I want to run examples without getting Test::Unit NameErrors
+
+  Scenario Outline: Spec including Test const but not Test::Unit
+    Given a file named "spec_including_test_but_not_unit.rb" with:
+    """
+    require 'spec/autorun'
+
+    module Test
+    end
+
+    describe "description" do
+      it "should description" do
+        1.should == 1
+      end
+    end
+    """
+    When I run "<Command> spec_including_test_but_not_unit.rb"
+    Then the stderr should not match "Test::Unit"
+
+  Scenarios: Run with ruby and spec
+    | Command |
+    | ruby    |
+    | spec    |

data/features/interop/test_case_with_should_methods.feature

@@ -0,0 +1,46 @@
+Feature: Test::Unit::TestCase extended by rspec with should methods
+
+  As an RSpec adopter with existing Test::Unit tests
+  I want to use should_* methods in a Test::Unit::TestCase
+  So that I use RSpec with classes and methods that look more like RSpec examples
+
+  Scenario Outline: TestCase with should methods
+    Given a file named "test_case_with_should_methods.rb" with:
+    """
+    require 'spec/autorun'
+    require 'spec/test/unit'
+
+    class MyTest < Test::Unit::TestCase
+      def should_pass_with_should
+        1.should == 1
+      end
+
+      def should_fail_with_should
+        1.should == 2
+      end
+
+      def should_pass_with_assert
+        assert true
+      end
+
+      def should_fail_with_assert
+        assert false
+      end
+
+      def test
+        raise "This is not a real test"
+      end
+
+      def test_ify
+        raise "This is a real test"
+      end
+    end
+    """
+    When I run "<Command> test_case_with_should_methods.rb"
+    Then the exit code should be 256
+    And the stdout should include "5 examples, 3 failures"
+
+  Scenarios: Run with ruby and spec
+    | Command |
+    | ruby    |
+    | spec    |

data/features/load_paths/add_lib_to_load_path.feature

@@ -0,0 +1,20 @@
+Feature: add ./lib to load path
+  In order to ...
+  As a spec author
+  I want rspec to add ./lib to the load path
+
+  Scenario: spec helper
+    Given a directory named "spec"
+    And a file named "example.rb" with:
+      """
+      describe $LOAD_PATH do
+        it "begins with 'lib' in the current directory in the load path" do
+          libdir = File.expand_path(File.join(File.dirname(__FILE__), 'lib'))
+          $LOAD_PATH.should include(libdir)
+        end
+      end
+      """
+    When I run "spec example.rb"
+    Then the stdout should include "1 example, 0 failures"
+    And  the exit code should be 0
+

data/features/load_paths/add_spec_to_load_path.feature

@@ -0,0 +1,20 @@
+Feature: add 'spec' to load path
+  In order to ...
+  As a spec author
+  I want rspec to add 'spec to the load path
+
+  Scenario: add 'spec' to load path
+    Given a directory named "spec"
+    And a file named "example.rb" with:
+      """
+      describe $LOAD_PATH do
+        it "includes with 'spec' in the current directory in the load path" do
+          specdir = File.expand_path(File.join(File.dirname(__FILE__), 'spec'))
+          $LOAD_PATH.should include(specdir)
+        end
+      end
+      """
+    When I run "spec example.rb"
+    Then the stdout should include "1 example, 0 failures"
+    And  the exit code should be 0
+

data/features/matchers/define_diffable_matcher.feature

@@ -0,0 +1,26 @@
+Feature: define diffable matcher
+
+  When a matcher is defined as diffable, and the --diff
+  flag is set, the output will include a diff of the submitted
+  objects.
+
+  Scenario: define a diffable matcher
+    Given a file named "diffable_matcher_spec.rb" with:
+      """
+      Spec::Matchers.define :be_just_like do |expected|
+        match do |actual|
+          actual == expected
+        end
+        
+        diffable
+      end
+
+      describe "this" do
+        it {should be_just_like("that")}
+      end
+      """
+    When I run "spec diffable_matcher_spec.rb --diff"
+    Then the exit code should be 256
+
+    And the stdout should include "should be just like \"that\""
+    And the stdout should include "Diff:\n@@ -1,2 +1,2 @@\n-that\n+this"

data/features/matchers/define_matcher.feature

@@ -0,0 +1,179 @@
+Feature: define matcher
+
+  In order to express my domain clearly in my code examples
+  As an RSpec user
+  I want a shortcut to define custom matchers
+
+  Scenario: define a matcher with default messages
+    Given a file named "matcher_with_default_message_spec.rb" with:
+      """
+      Spec::Matchers.define :be_a_multiple_of do |expected|
+        match do |actual|
+          actual % expected == 0
+        end
+      end
+
+      describe 9 do
+        it {should be_a_multiple_of(3)}
+      end
+
+      describe 9 do
+        it {should_not be_a_multiple_of(4)}
+      end
+
+      # fail intentionally to generate expected output
+      describe 9 do
+        it {should be_a_multiple_of(4)}
+      end
+
+      # fail intentionally to generate expected output
+      describe 9 do
+        it {should_not be_a_multiple_of(3)}
+      end
+
+      """
+    When I run "spec matcher_with_default_message_spec.rb --format specdoc"
+    Then the exit code should be 256
+
+    And the stdout should include "should be a multiple of 3"
+    And the stdout should include "should not be a multiple of 4"
+    And the stdout should include "should be a multiple of 4 (FAILED - 1)"
+    And the stdout should include "should not be a multiple of 3 (FAILED - 2)"
+
+    And the stdout should include "4 examples, 2 failures"
+    And the stdout should include "expected 9 to be a multiple of 4"
+    And the stdout should include "expected 9 not to be a multiple of 3"
+
+  Scenario: overriding the failure_message_for_should
+    Given a file named "matcher_with_failure_message_spec.rb" with:
+      """
+      Spec::Matchers.define :be_a_multiple_of do |expected|
+        match do |actual|
+          actual % expected == 0
+        end
+        failure_message_for_should do |actual|
+          "expected that #{actual} would be a multiple of #{expected}"
+        end
+      end
+
+      # fail intentionally to generate expected output
+      describe 9 do
+        it {should be_a_multiple_of(4)}
+      end
+      """
+    When I run "spec matcher_with_failure_message_spec.rb"
+    Then the exit code should be 256
+    And the stdout should include "1 example, 1 failure"
+    And the stdout should include "expected that 9 would be a multiple of 4"
+
+  Scenario: overriding the failure_message_for_should_not
+    Given a file named "matcher_with_failure_for_message_spec.rb" with:
+      """
+      Spec::Matchers.define :be_a_multiple_of do |expected|
+        match do |actual|
+          actual % expected == 0
+        end
+        failure_message_for_should_not do |actual|
+          "expected that #{actual} would not be a multiple of #{expected}"
+        end
+      end
+
+      # fail intentionally to generate expected output
+      describe 9 do
+        it {should_not be_a_multiple_of(3)}
+      end
+      """
+    When I run "spec matcher_with_failure_for_message_spec.rb"
+    Then the exit code should be 256
+    And the stdout should include "1 example, 1 failure"
+    And the stdout should include "expected that 9 would not be a multiple of 3"
+
+  Scenario: overriding the description
+    Given a file named "matcher_overriding_description_spec.rb" with:
+      """
+      Spec::Matchers.define :be_a_multiple_of do |expected|
+        match do |actual|
+          actual % expected == 0
+        end
+        description do
+          "be multiple of #{expected}"
+        end
+      end
+
+      describe 9 do
+        it {should be_a_multiple_of(3)}
+      end
+
+      describe 9 do
+        it {should_not be_a_multiple_of(4)}
+      end
+      """
+    When I run "spec matcher_overriding_description_spec.rb --format specdoc"
+    Then the exit code should be 0
+    And the stdout should include "2 examples, 0 failures"
+    And the stdout should include "should be multiple of 3"
+    And the stdout should include "should not be multiple of 4"
+
+  Scenario: with no args
+    Given a file named "matcher_with_no_args_spec.rb" with:
+      """
+      Spec::Matchers.define :have_7_fingers do
+        match do |thing|
+          thing.fingers.length == 7
+        end
+      end
+
+      class Thing
+        def fingers; (1..7).collect {"finger"}; end
+      end
+
+      describe Thing do
+        it {should have_7_fingers}
+      end
+      """
+    When I run "spec matcher_with_no_args_spec.rb --format specdoc"
+    Then the exit code should be 0
+    And the stdout should include "1 example, 0 failures"
+    And the stdout should include "should have 7 fingers"
+
+  Scenario: with multiple args
+    Given a file named "matcher_with_multiple_args_spec.rb" with:
+      """
+      Spec::Matchers.define :be_the_sum_of do |a,b,c,d|
+        match do |sum|
+          a + b + c + d == sum
+        end
+      end
+
+      describe 10 do
+        it {should be_the_sum_of(1,2,3,4)}
+      end
+      """
+    When I run "spec matcher_with_multiple_args_spec.rb --format specdoc"
+    Then the exit code should be 0
+    And the stdout should include "1 example, 0 failures"
+    And the stdout should include "should be the sum of 1, 2, 3, and 4"
+    
+  Scenario: with helper methods
+    Given a file named "matcher_with_internal_helper_spec.rb" with:
+      """
+      Spec::Matchers.define :have_same_elements_as do |sample|
+        match do |actual|
+          similar?(sample, actual)
+        end
+        
+        def similar?(a, b)
+          a.sort == b.sort
+        end
+      end
+      
+      describe "these two arrays" do
+        specify "should be similar" do
+          [1,2,3].should have_same_elements_as([2,3,1])
+        end
+      end
+      """
+    When I run "spec matcher_with_internal_helper_spec.rb"
+    Then the exit code should be 0
+    And the stdout should include "1 example, 0 failures"
+

data/features/matchers/define_matcher_outside_rspec.feature

@@ -0,0 +1,38 @@
+Feature: define matcher outside rspec
+
+  In order to express my domain clearly in my code examples
+  As a non-rspec user
+  I want a shortcut to define custom matchers
+
+  Scenario: define a matcher with default messages
+    Given a file named "test_multiples.rb" with:
+      """
+      require 'test/unit'
+      require 'spec/expectations'
+      
+      Spec::Matchers.define :be_a_multiple_of do |expected|
+        match do |actual|
+          actual % expected == 0
+        end
+      end
+      
+      class Test::Unit::TestCase
+        include Spec::Matchers
+      end
+      
+      class TestMultiples < Test::Unit::TestCase
+      
+        def test_9_should_be_a_multiple_of_3
+          9.should be_a_multiple_of(3)
+        end
+
+        def test_9_should_be_a_multiple_of_4
+          9.should be_a_multiple_of(4)
+        end
+        
+      end
+      """
+    When I run "ruby test_multiples.rb"
+    Then the exit code should be 256
+    And the stdout should include "expected 9 to be a multiple of 4"
+    And the stdout should include "2 tests, 0 assertions, 1 failures, 0 errors"

data/features/matchers/define_matcher_with_fluent_interface.feature

@@ -0,0 +1,48 @@
+Feature: define matcher
+
+  In order to express my domain clearly in my code examples
+  As an RSpec user
+  I want to define matchers with fluent interfaces
+  
+  Scenario: one additional method
+    Given a file named "between_spec.rb" with:
+      """
+      Spec::Matchers.define :be_bigger_than do |first|
+        def but_smaller_than(second)
+          @second = second
+          self
+        end
+        
+        match do |actual|
+          (actual > first) && (actual < @second)
+        end
+      end
+
+      describe 5 do
+        it { should be_bigger_than(4).but_smaller_than(6) }
+      end
+      """
+    When I run "spec between_spec.rb --format specdoc"
+    Then the stdout should include "1 example, 0 failures"
+    And  the stdout should include "should be bigger than 4"
+
+  Scenario: generate method using dsl
+    Given a file named "between_spec.rb" with:
+      """
+      Spec::Matchers.define :be_bigger_than do |first|
+        chain :but_smaller_than do |limit|
+          @limit = limit
+        end
+        
+        match do |actual|
+          (actual > first) && (actual < @limit)
+        end
+      end
+
+      describe 5 do
+        it { should be_bigger_than(4).but_smaller_than(6) }
+      end
+      """
+    When I run "spec between_spec.rb --format specdoc"
+    Then the stdout should include "1 example, 0 failures"
+    And  the stdout should include "should be bigger than 4"

data/features/matchers/define_wrapped_matcher.feature

@@ -0,0 +1,56 @@
+Feature: define wrapped matcher
+
+  In order to reuse existing matchers
+  As an RSpec user
+  I want to define matchers that wrap other matchers
+
+  When the wrapped matcher passes, the wrapping matcher returns true.
+  When the wrapped matcher fails, the wrapping matcher returns false.
+  
+  Scenario: wrap a matcher using should
+    Given a file named "new_model_spec.rb" with:
+      """
+      Spec::Matchers.define :have_tag do |tag|
+        match do |markup|
+          markup =~ /<#{tag}>.*<\/#{tag}>/
+        end
+      end
+      
+      Spec::Matchers.define :have_button do
+        match do |markup|
+          markup.should have_tag('button')
+        end
+      end
+      
+      describe "some markup" do
+        it "has a button" do
+          "<button>Label</button>".should have_button
+        end
+      end
+      """
+    When I run "spec new_model_spec.rb --format specdoc"
+    Then the stdout should include "1 example, 0 failures"
+
+  Scenario: wrap a matcher using should_not
+    Given a file named "new_model_spec.rb" with:
+      """
+      Spec::Matchers.define :have_tag do |tag|
+        match do |markup|
+          markup =~ /<#{tag}>.*<\/#{tag}>/
+        end
+      end
+      
+      Spec::Matchers.define :have_button do
+        match do |markup|
+          markup.should have_tag('button')
+        end
+      end
+      
+      describe "some markup" do
+        it "has no buttons" do
+          "<p>Label</p>".should_not have_button
+        end
+      end
+      """
+    When I run "spec new_model_spec.rb --format specdoc"
+    Then the stdout should include "1 example, 0 failures"

data/features/matchers/match_unless_raises.feature

@@ -0,0 +1,60 @@
+Feature: match unless raises
+
+  In order, primarily, to reuse existing test/unit assertions
+  As an RSpec user
+  I want to define matchers that wrap a statement that raises an error on failure
+
+  Background:
+    Given a file named "example.rb" with:
+      """
+      require 'test/unit/assertions'
+
+      Spec::Matchers.define :be_the_same_as do |expected|
+        extend Test::Unit::Assertions
+        match_unless_raises Test::Unit::AssertionFailedError do |actual|
+          assert_equal expected, actual
+        end
+      end
+      """
+  
+  Scenario: passing examples
+    Given a file named "match_unless_raises_spec.rb" with:
+      """
+      require 'example.rb'
+
+      describe 4 do
+        it "is 4" do
+          4.should be_the_same_as(4)
+        end
+      end
+
+      describe 5 do
+        it "is not 4" do
+          5.should_not be_the_same_as(4)
+        end
+      end
+      """
+    When I run "spec match_unless_raises_spec.rb"
+    Then the stdout should include "2 examples, 0 failures"
+
+  Scenario: failing examples
+    Given a file named "match_unless_raises_spec.rb" with:
+      """
+      require 'example.rb'
+
+      describe 4 do
+        it "is 4" do
+          # intentionally fail
+          4.should_not be_the_same_as(4)
+        end
+      end
+
+      describe 5 do
+        it "is not 4" do
+          # intentionally fail
+          5.should be_the_same_as(4)
+        end
+      end
+      """
+    When I run "spec match_unless_raises_spec.rb"
+    Then the stdout should include "2 examples, 2 failures"

data/features/matchers/match_unless_raises_unexpected_error.feature

@@ -0,0 +1,39 @@
+Feature: match unless raises with an unexpected error
+
+  In order to know when a match_unless_raises block raises an unexpected error
+  As an RSpec user
+  I want the error to bubble up
+
+  Background:
+    Given a file named "example.rb" with:
+      """
+      Spec::Matchers.define :be_the_same_as do |expected|
+        match_unless_raises SyntaxError do |actual|
+          raise "unexpected error"
+        end
+      end
+      """
+  
+  Scenario: failing examples
+    Given a file named "match_unless_raises_spec.rb" with:
+      """
+      require 'example.rb'
+
+      describe 4 do
+        it "is 4" do
+          # intentionally fail
+          4.should_not be_the_same_as(4)
+        end
+      end
+
+      describe 5 do
+        it "is not 4" do
+          # intentionally fail
+          5.should be_the_same_as(4)
+        end
+      end
+      """
+    When I run "spec match_unless_raises_spec.rb"
+    Then the stdout should include "2 examples, 2 failures"
+    Then the stdout should include "unexpected error"
+