rspec 1.0.8 → 1.1.0

data/spec/spec/translator_spec.rb

@@ -1,4 +1,5 @@
 require File.dirname(__FILE__) + '/../spec_helper.rb'
+require 'spec/translator'
 
 describe "Translator" do
   before do
@@ -7,7 +8,7 @@ describe "Translator" do
   
   it "should translate files" do
     from = File.dirname(__FILE__) + '/..'
-    to = File.dirname(__FILE__) + '/../../translated_specs'
+    to = "#{Dir.tmpdir}/translated_specs"
     @t.translate_dir(from, to)
   end
 

data/spec/spec_helper.rb

@@ -1,5 +1,4 @@
 require 'stringio'
-require 'rbconfig'
 
 dir = File.dirname(__FILE__)
 lib_path = File.expand_path("#{dir}/../lib")
@@ -8,9 +7,10 @@ $_spec_spec = true # Prevents Kernel.exit in various places
 
 require 'spec'
 require 'spec/mocks'
-require 'hpricot' # Needed to compare generated with wanted HTML
+require 'spec/story'
 spec_classes_path = File.expand_path("#{dir}/../spec/spec/spec_classes")
 require spec_classes_path unless $LOAD_PATH.include?(spec_classes_path)
+require File.dirname(__FILE__) + '/../lib/spec/expectations/differs/default'
 
 module Spec
   module Matchers
@@ -40,7 +40,64 @@ module Spec
     def pass
       Pass.new
     end
+    
+    class CorrectlyOrderedMockExpectation
+      def initialize(&event)
+        @event = event
+      end
+      
+      def expect(&expectations)
+        expectations.call
+        @event.call
+      end
+    end
+    
+    def during(&block)
+      CorrectlyOrderedMockExpectation.new(&block) 
+    end
   end
 end
 
 class NonStandardError < Exception; end
+
+module Custom
+  class ExampleGroupRunner
+    attr_reader :options, :arg
+    def initialize(options, arg)
+      @options, @arg = options, arg
+    end
+
+    def load_files(files)
+    end
+
+    def run
+    end
+  end  
+end
+
+def exception_from(&block)
+  exception = nil
+  begin
+    yield
+  rescue StandardError => e
+    exception = e
+  end
+  exception
+end
+
+describe "sandboxed rspec_options", :shared => true do
+  attr_reader :options
+
+  before(:all) do
+    @original_rspec_options = $rspec_options
+  end
+
+  before(:each) do
+    @options = ::Spec::Runner::Options.new(StringIO.new, StringIO.new)
+    $rspec_options = options
+  end
+
+  after do
+    $rspec_options = @original_rspec_options
+  end
+end

data/stories/all.rb

@@ -0,0 +1,5 @@
+require File.join(File.dirname(__FILE__), *%w[helper])
+
+["example_groups","interop"].each do |dir|
+  require File.join(File.dirname(__FILE__), "#{dir}/stories")
+end

data/stories/example_groups/autogenerated_docstrings

@@ -0,0 +1,26 @@
+Story: autogenerated 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: run with ruby
+    Given the file ../../examples/pure/autogenerated_docstrings_example.rb
+
+    When I run it with the ruby interpreter -fs
+
+    Then the stdout should match /should equal 5/
+    And the stdout should match /should be < 5/
+    And the stdout should match /should include "a"/
+    And the stdout should match /should respond to #size/
+
+    Scenario: run with spec
+      Given the file ../../examples/pure/autogenerated_docstrings_example.rb
+
+      When I run it with the spec script -fs
+
+      Then the stdout should match /should equal 5/
+      And the stdout should match /should be < 5/
+      And the stdout should match /should include "a"/
+      And the stdout should match /should respond to #size/
+

data/stories/example_groups/example_group_with_should_methods

@@ -0,0 +1,17 @@
+Story: 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: Run with ruby
+    Given the file spec/example_group_with_should_methods.rb
+    When I run it with the ruby interpreter
+    Then the exit code should be 256
+    And the stdout should match "2 examples, 1 failure"
+
+  Scenario: Run with spec
+  Given the file spec/example_group_with_should_methods.rb
+    When I run it with the spec script
+    Then the exit code should be 256
+    And the stdout should match "2 examples, 1 failure"

data/stories/example_groups/nested_groups

@@ -0,0 +1,17 @@
+Story: Nested example groups
+
+  As an RSpec user
+  I want to nest examples groups
+  So that I can better organize my examples
+
+  Scenario: Run with ruby
+    Given the file ../../examples/pure/stack_spec_with_nested_example_groups.rb
+    When I run it with the ruby interpreter -fs
+    Then the stdout should match /Stack \(empty\)/
+    And the stdout should match /Stack \(full\)/
+
+  Scenario: Run with ruby
+    Given the file ../../examples/pure/stack_spec_with_nested_example_groups.rb
+    When I run it with the spec script -fs
+    Then the stdout should match /Stack \(empty\)/
+    And the stdout should match /Stack \(full\)/

data/stories/example_groups/output

@@ -0,0 +1,20 @@
+Story: Getting correct output
+
+  As an RSpec user
+  I want to see output only once
+  So that I don't get confused
+
+  Scenario: Run with ruby
+    Given the file spec/simple_spec.rb
+    When I run it with the ruby interpreter
+    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 match "1 example, 0 failures"
+
+  Scenario: Run with CommandLine object
+    Given the file spec/simple_spec.rb
+    When I run it with the CommandLine object
+    Then the exit code should be 0
+    And the stdout should not match "Loaded suite"
+    And the stdout should not match /\d+ tests, \d+ assertions, \d+ failures, \d+ errors/m
+    And the stdout should match "1 example, 0 failures"

data/stories/example_groups/stories.rb

@@ -0,0 +1,7 @@
+require File.join(File.dirname(__FILE__), *%w[.. helper])
+
+with_steps_for :running_rspec do
+  Dir["#{File.dirname(__FILE__)}/*"].each do |file|
+    run file if File.file?(file) && !(file =~ /\.rb$/)
+  end
+end

data/stories/helper.rb

@@ -0,0 +1,6 @@
+$LOAD_PATH.unshift File.expand_path("#{File.dirname(__FILE__)}/../lib")
+require 'spec'
+require 'tempfile'
+require File.join(File.dirname(__FILE__), *%w[resources matchers smart_match])
+require File.join(File.dirname(__FILE__), *%w[resources helpers story_helper])
+require File.join(File.dirname(__FILE__), *%w[resources steps running_rspec])

data/stories/interop/examples_and_tests_together

@@ -0,0 +1,30 @@
+Story: 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: Run with ruby
+    Given the file test/spec_and_test_together.rb
+
+    When I run it with the ruby interpreter -fs
+
+    Then the exit code should be 256
+    And the stdout should match "ATest"
+    And the stdout should match "Test::Unit::AssertionFailedError in 'An Example should fail with assert'"
+    And the stdout should match "'An Example should fail with should' FAILED"
+    And the stdout should match "10 examples, 6 failures"
+    And the stdout should match /expected: 40,\s*got: 4/m
+    And the stdout should match /expected: 50,\s*got: 5/m
+  Scenario: Run with spec
+    Given the file test/spec_and_test_together.rb
+
+    When I run it with the spec script -fs
+
+    Then the exit code should be 256
+    Ands the stdout should match "ATest"
+    And the stdout should match "Test::Unit::AssertionFailedError in 'An Example should fail with assert'"
+    And the stdout should match "'An Example should fail with should' FAILED"
+    And the stdout should match "10 examples, 6 failures"
+    And the stdout should match /expected: 40,\s*got: 4/m
+    And the stdout should match /expected: 50,\s*got: 5/m

data/stories/interop/stories.rb

@@ -0,0 +1,7 @@
+require File.join(File.dirname(__FILE__), *%w[.. helper])
+
+with_steps_for :running_rspec do
+  Dir["#{File.dirname(__FILE__)}/*"].each do |file|
+    run file if File.file?(file) && !(file =~ /\.rb$/)
+  end
+end

data/stories/interop/test_case_with_should_methods

@@ -0,0 +1,17 @@
+Story: 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: Run with ruby
+    Given the file test/test_case_with_should_methods.rb
+    When I run it with the ruby interpreter
+    Then PENDING the exit code should be 256
+    And the stdout should match "5 examples, 3 failures"
+
+  Scenario: Run with spec
+    Given the file test/test_case_with_should_methods.rb
+    When I run it with the spec script
+    Then the exit code should be 256
+    And the stdout should match "5 examples, 3 failures"

data/stories/pending_stories/README

@@ -0,0 +1,3 @@
+This directory contains stories that are currently not passing
+because they are new or they represent regressions.
+

data/stories/resources/helpers/cmdline.rb

@@ -0,0 +1,9 @@
+$:.push File.join(File.dirname(__FILE__), *%w[.. .. .. lib])
+require 'spec'
+
+# Uncommenting next line will break the output story (no output!!)
+# rspec_options
+options = Spec::Runner::OptionParser.parse(
+  ARGV, $stderr, $stdout
+)
+Spec::Runner::CommandLine.run(options)

data/stories/resources/helpers/story_helper.rb

@@ -0,0 +1,16 @@
+require 'spec/story'
+require File.dirname(__FILE__) + '/../../../spec/ruby_forker'
+
+module StoryHelper
+  include RubyForker
+
+  def spec(args, stderr)
+    ruby("#{File.dirname(__FILE__) + '/../../../bin/spec'} #{args}", stderr)
+  end
+
+  def cmdline(args, stderr)
+    ruby("#{File.dirname(__FILE__) + '/../../resources/helpers/cmdline.rb'} #{args}", stderr)
+  end
+  
+  Spec::Story::World.send :include, self
+end

data/stories/resources/matchers/smart_match.rb

@@ -0,0 +1,37 @@
+module Spec
+  module Matchers
+    class SmartMatch
+      def initialize(expected)
+        @expected = expected
+      end
+
+      def matches?(actual)
+        @actual = actual
+        # Satisfy expectation here. Return false or raise an error if it's not met.
+
+        if @expected =~ /^\/.*\/?$/ || @expected =~ /^".*"$/
+          regex_or_string = eval(@expected)
+          if Regexp === regex_or_string
+            (@actual =~ regex_or_string) ? true : false
+          else
+            @actual.index(regex_or_string) != nil
+          end
+        else
+          false
+        end
+      end
+
+      def failure_message
+        "expected #{@actual.inspect} to smart_match #{@expected.inspect}, but it didn't"
+      end
+
+      def negative_failure_message
+        "expected #{@actual.inspect} not to smart_match #{@expected.inspect}, but it did"
+      end
+    end
+
+    def smart_match(expected)
+      SmartMatch.new(expected)
+    end
+  end
+end

data/stories/resources/spec/example_group_with_should_methods.rb

@@ -0,0 +1,12 @@
+$:.push File.join(File.dirname(__FILE__), *%w[.. .. .. lib])
+require 'spec'
+
+class MySpec < Spec::ExampleGroup
+  def should_pass_with_should
+    1.should == 1
+  end
+
+  def should_fail_with_should
+    1.should == 2
+  end
+end

data/stories/resources/spec/simple_spec.rb

@@ -0,0 +1,8 @@
+$:.push File.join(File.dirname(__FILE__), *%w[.. .. .. lib])
+require 'spec'
+
+describe "Running an Example" do
+  it "should not output twice" do
+    true.should be_true
+  end
+end

data/stories/resources/steps/running_rspec.rb

@@ -0,0 +1,50 @@
+steps_for :running_rspec do
+
+  Given("the file $relative_path") do |relative_path|
+    @path = File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "resources", relative_path))
+    unless File.exist?(@path)
+      raise "could not find file at #{@path}"
+    end
+  end
+  
+  When("I run it with the $interpreter") do |interpreter|
+    stderr_file = Tempfile.new('rspec')
+    stderr_file.close
+    @stdout = case(interpreter)
+      when /^ruby interpreter/
+        args = interpreter.gsub('ruby interpreter','')
+        ruby("#{@path}#{args}", stderr_file.path)
+      when /^spec script/
+        args = interpreter.gsub('spec script','')
+        spec("#{@path}#{args}", stderr_file.path)
+      when 'CommandLine object' then cmdline(@path, stderr_file.path)
+      else raise "Unknown interpreter: #{interpreter}"
+    end
+    @stderr = IO.read(stderr_file.path)
+    @exit_code = $?.to_i
+  end
+  
+  Then("the exit code should be $exit_code") do |exit_code|
+    if @exit_code != exit_code.to_i
+      raise "Did not exit with #{exit_code}, but with #{@exit_code}. Standard error:\n#{@stderr}"
+    end
+  end
+  
+  Then("the $stream should match $regex") do |stream, string_or_regex|
+    written = case(stream)
+      when 'stdout' then @stdout
+      when 'stderr' then @stderr
+      else raise "Unknown stream: #{stream}"
+    end
+    written.should smart_match(string_or_regex)
+  end
+  
+  Then("the $stream should not match $regex") do |stream, string_or_regex|
+    written = case(stream)
+      when 'stdout' then @stdout
+      when 'stderr' then @stderr
+      else raise "Unknown stream: #{stream}"
+    end
+    written.should_not smart_match(string_or_regex)
+  end
+end

data/stories/resources/test/spec_and_test_together.rb

@@ -0,0 +1,57 @@
+$:.push File.join(File.dirname(__FILE__), *%w[.. .. .. lib])
+require 'spec'
+# TODO - this should not be necessary, ay?
+require 'spec/interop/test'
+
+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
+end