typo 5.1.3 → 5.1.98

data/vendor/plugins/rspec/spec/spec/story/runner_spec.rb

@@ -1,29 +1,19 @@
 require File.dirname(__FILE__) + '/story_helper'
+require 'spec/runner/formatter/story/plain_text_formatter'
+require 'spec/runner/formatter/story/html_formatter'
 
 module Spec
   module Story
     describe Runner, "module" do
-      def dev_null
-        io = StringIO.new
-        def io.write(str)
-          str.to_s.size
-        end
-        return io
-      end
-      
-      before :each do
-        Kernel.stub!(:at_exit)
-        @stdout, $stdout = $stdout, dev_null
-        @argv = Array.new(ARGV)
-        @runner_module = Runner.dup
+      before(:each) do
         @world_creator = World.dup
-        @runner_module.module_eval { @run_options = @story_runner = @scenario_runner = @world_creator = nil }
+        @runner_module = Runner.dup
+        @runner_module.instance_eval {@story_runner = nil}
+        @runner_module.stub!(:register_exit_hook)
       end
       
-      after :each do
-        $stdout = @stdout
-        ARGV.replace @argv
-        @runner_module.module_eval { @run_options = @story_runner = @scenario_runner = @world_creator = nil }
+      def create_options(args=[])
+        Spec::Runner::OptionParser.parse(args, StringIO.new, StringIO.new)
       end
       
       it 'should wire up a singleton StoryRunner' do
@@ -32,75 +22,72 @@ module Spec
       
       it 'should set its options based on ARGV' do
         # given
-        ARGV << '--dry-run'
-        
+        @runner_module.should_receive(:run_options).and_return(
+          create_options(['--dry-run'])
+        )
+
         # when
         options = @runner_module.run_options
         
         # then
         options.dry_run.should be_true
       end
-
-      it 'should add a reporter to the runner classes' do
-        # given
-        story_runner = mock('story runner', :null_object => true)
-        scenario_runner = mock('scenario runner', :null_object => true)
-        world_creator = mock('world', :null_object => true)
-        
-        @runner_module::class_eval { @world_creator = world_creator }
-        @runner_module::StoryRunner.stub!(:new).and_return(story_runner)
-        @runner_module::ScenarioRunner.stub!(:new).and_return(scenario_runner)
-        
-        # expect
-        world_creator.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::PlainTextFormatter))
-        story_runner.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::PlainTextFormatter))
-        scenario_runner.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::PlainTextFormatter))
-        
-        # when
-        @runner_module.story_runner
-      end
       
-      it 'should add a documenter to the runner classes if one is specified' do
-        # given
-        ARGV << "--format" << "html"
-        story_runner = mock('story runner', :null_object => true)
-        scenario_runner = mock('scenario runner', :null_object => true)
-        world_creator = mock('world', :null_object => true)
+      describe "initialization" do
         
-        @runner_module::class_eval { @world_creator = world_creator }
-        @runner_module::StoryRunner.stub!(:new).and_return(story_runner)
-        @runner_module::ScenarioRunner.stub!(:new).and_return(scenario_runner)
+        before(:each) do
+          # given
+          @story_runner = mock('story runner', :null_object => true)
+          @scenario_runner = mock('scenario runner', :null_object => true)
+          @world_creator = mock('world', :null_object => true)
         
-        # expect
-        world_creator.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::HtmlFormatter))
-        story_runner.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::HtmlFormatter))
-        scenario_runner.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::HtmlFormatter))
+          @runner_module.stub!(:world_creator).and_return(@world_creator)
+          @runner_module.stub!(:create_story_runner).and_return(@story_runner)
+          @runner_module.stub!(:scenario_runner).and_return(@scenario_runner)
+        end
+
+        it 'should add a reporter to the runner classes' do
+          @runner_module.should_receive(:run_options).and_return(
+            create_options
+          )
         
-        # when
-        @runner_module.story_runner
-      end
+          # expect
+          @world_creator.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::PlainTextFormatter))
+          @story_runner.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::PlainTextFormatter))
+          @scenario_runner.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::PlainTextFormatter))
+        
+          # when
+          @runner_module.story_runner
+        end
       
-      it 'should add any registered listener to the runner classes' do
-        # given
-        ARGV << "--format" << "html"
-        story_runner = mock('story runner', :null_object => true)
-        scenario_runner = mock('scenario runner', :null_object => true)
-        world_creator = mock('world', :null_object => true)
+        it 'should add a documenter to the runner classes if one is specified' do
         
-        @runner_module::class_eval { @world_creator = world_creator }
-        @runner_module::StoryRunner.stub!(:new).and_return(story_runner)
-        @runner_module::ScenarioRunner.stub!(:new).and_return(scenario_runner)
+          @runner_module.should_receive(:run_options).and_return(
+            create_options(["--format","html"])
+          )
+
+          # expect
+          @world_creator.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::HtmlFormatter))
+          @story_runner.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::HtmlFormatter))
+          @scenario_runner.should_receive(:add_listener).with(an_instance_of(Spec::Runner::Formatter::Story::HtmlFormatter))
         
-        listener = Object.new
+          # when
+          @runner_module.story_runner
+        end
+      
+        it 'should add any registered listener to the runner classes' do
+          # given
+          listener = Object.new
         
-        # expect
-        world_creator.should_receive(:add_listener).with(listener)
-        story_runner.should_receive(:add_listener).with(listener)
-        scenario_runner.should_receive(:add_listener).with(listener)
+          # expect
+          @world_creator.should_receive(:add_listener).with(listener)
+          @story_runner.should_receive(:add_listener).with(listener)
+          @scenario_runner.should_receive(:add_listener).with(listener)
         
-        # when
-        @runner_module.register_listener listener
+          # when
+          @runner_module.register_listener listener
+        end
+      end
       end
-    end
   end
 end

data/vendor/plugins/rspec/spec/spec/story/scenario_spec.rb

@@ -8,9 +8,7 @@ module Spec
         story = StoryBuilder.new.to_story
         
         # when
-        error = exception_from do
-          Scenario.new story, 'name'
-        end
+        error = exception_from { Scenario.new story, 'name' }
         
         # then
         error.should be_nil

data/vendor/plugins/rspec/spec/spec/story/step_mother_spec.rb

@@ -42,6 +42,18 @@ module Spec
         end.should raise_error(Spec::Example::ExamplePendingError, /Unimplemented/)
       end
       
+      it "should create a default step with it's name stripped" do
+        # given
+        step_mother = StepMother.new
+        
+        # when
+        step = step_mother.find(:given, "doesn't exist\n\n")
+        
+        # then
+        step.should be_an_instance_of(Step)
+        step.name.should == "doesn't exist"
+      end
+      
       it 'should clear itself' do
         # given
         step_mother = StepMother.new

data/vendor/plugins/rspec/spec/spec/story/step_spec.rb

@@ -2,12 +2,17 @@ require File.dirname(__FILE__) + '/story_helper'
 
 module Spec
   module Story
-    describe Step, "matching" do
+    describe Step, "#matching" do
       it "should match a text string" do
         step = Step.new("this text") {}
         step.matches?("this text").should be_true
       end
       
+      it "should match a text string that has additional line returns" do
+        step = Step.new("this text") {}
+        step.matches?("this text\n\n").should be_true
+      end
+      
       it "should not match a text string that does not start the same" do
         step = Step.new("this text") {}
         step.matches?("Xthis text").should be_false
@@ -32,6 +37,11 @@ module Spec
         step = Step.new("1 $one 2 $two 3 $three 4") {}
         step.matches?("1 a 2 b 3 c 4").should be_true
       end
+
+      it "should match a text string with two params sharing a prefix" do
+        step = Step.new("I am cool $n times out of $n_total")
+        step.matches?("I am cool 3 times out of 7").should be_true
+      end
       
       it "should match a text string with a param at the beginning" do
         step = Step.new("$one 2 3") {}
@@ -42,6 +52,16 @@ module Spec
         step = Step.new("1 2 $three") {}
         step.matches?("1 2 c").should be_true
       end
+
+      it "should match a text string with a dollar sign ($)" do
+        step = Step.new("show me the $$money") {}
+        step.matches?("show me the $kwan").should be_true
+      end
+
+      it "should match a string with an escaped dollar sign" do
+        step = Step.new("show me the \$money") {}
+        step.matches?("show me the $kwan").should be_true
+      end
       
       it "should not match a different string" do
         step = Step.new("this text") {}
@@ -78,6 +98,11 @@ module Spec
         step.matches?("before () after").should be_true
       end
       
+      it "should not get bogged down by regular expression special characters in strings" do
+        step = Step.new("These characters should work ? ( ) [ ] { } ^ !") {}
+        step.matches?("These characters should work ? ( ) [ ] { } ^ !").should be_true
+      end
+      
       it "should match any option of an alteration" do
         step = Step.new(/(he|she) is cool/) {}
         step.matches?("he is cool").should be_true
@@ -101,14 +126,61 @@ module Spec
         step.matches?("he is very cool").should be_true
         step.parse_args("he is very cool").should == ['he', 'very', 'cool']
       end
+
+      it "should match a regex with a dollar sign ($)" do
+        step = Step.new(/show me the \$\d+/) {}
+        step.matches?("show me the $123").should be_true
+      end
+
+      it "should match a regex with a dollar sign and named variable" do
+        step = Step.new(/show me the \$$money/) {}
+        step.matches?("show me the $123").should be_true
+      end
+      
+      it "should match a multiline regex" do
+        step = Step.new(/.*should have text.$text/) {}
+        step.matches?(<<TEXT).should be_true
+          should have text
+          this is the text
+          and so is this
+TEXT
+      end
       
+      it "should match the beginning of the string, not the line" do
+        step = Step.new(/should have text/) {}
+        step.matches?(<<TEXT).should be_false
+whatever
+should have text
+TEXT
+      end
+
+      it "should match the end of the string, not the line" do
+        step = Step.new(/should have text/) {}
+        step.matches?(<<TEXT).should be_false
+should have text
+whatever
+TEXT
+      end
+    end
+    
+    describe Step, "#parse_args" do
+      it "should return an empty array for a text string with no parameters" do
+        step = Step.new("this text") {}
+        step.parse_args("this text").should == []
+      end
+      
+      it "should return an empty array for a text string with additional line returns and no parameters" do
+        step = Step.new("this text") {}
+        step.parse_args("this text\n\n").should == []
+      end
     end
     
     describe Step do
-      it "should make complain with no block" do
+      it "should be pending with no block" do
+        step = Step.new("foo")
         lambda {
-          step = Step.new("foo")
-        }.should raise_error
+          step.perform(Object.new)
+        }.should raise_error(Spec::Example::ExamplePendingError, "Not Yet Implemented")
       end
       
       it "should perform itself on an object" do

data/vendor/plugins/rspec/spec/spec/story/story_spec.rb

@@ -20,15 +20,13 @@ module Spec
       
       it 'should not raise an error if no block is supplied' do
         # when
-        error = exception_from do
-          Story.new 'title', 'narrative'
-        end
+        error = exception_from { Story.new 'title', 'narrative' }
         
         # then
         error.should be_nil
       end
       
-      it "should raise when error raised running in another object" do
+      it "should raise an error when an error is raised running in another object" do
         #given
         story = Story.new 'title', 'narrative' do
           raise "this is raised in the story"
@@ -42,7 +40,7 @@ module Spec
       end
       
       it "should use the steps it is told to using a StepGroup" do
-        story = Story.new("title", "narrative", :steps => steps = StepGroup.new) do end
+        story = Story.new("title", "narrative", :steps_for => steps = StepGroup.new) do end
         assignee = mock("assignee")
         assignee.should_receive(:use).with(steps)
         story.assign_steps_to(assignee)

data/vendor/plugins/rspec/spec/spec/story/world_spec.rb

@@ -324,7 +324,7 @@ module Spec
 
       it 'should tell listeners but not execute the step in dry-run mode' do
         # given
-        Runner.stub!(:dry_run).and_return(true)
+        World.stub!(:dry_run).and_return(true)
         mock_listener = mock('listener')
         World.add_listener(mock_listener)
         $step_invoked = false
@@ -347,10 +347,10 @@ module Spec
 
       it 'should suppress listeners while it runs a GivenScenario' do
         # given
-        $scenario_ran = false
+        scenario_ran = false
 
         scenario = ScenarioBuilder.new.name('a scenario').to_scenario do
-          $scenario_ran = true
+          scenario_ran = true
           Given 'given' do end
           When 'event' do end
           Then 'outcome' do end
@@ -374,16 +374,16 @@ module Spec
         world.GivenScenario 'a scenario'
 
         # then
-        $scenario_ran.should be_true
+        scenario_ran.should be_true
       end
 
       it 'should interpret GivenScenario... And... as multiple givens' do
         # given
         world = World.create
-        $steps = []
+        steps = []
 
         scenario = ScenarioBuilder.new.name('a scenario').to_scenario do
-          $steps << 1
+          steps << 1
         end
         Runner::StoryRunner.should_receive(:scenario_from_current_story).
           with('a scenario').and_return(scenario)
@@ -392,12 +392,12 @@ module Spec
         world.instance_eval do
           GivenScenario 'a scenario'
           And 'step 2' do
-            $steps << 2
+            steps << 2
           end
         end
 
         # then
-        $steps.should == [1,2]
+        steps.should == [1,2]
         World.step_mother.find(:given, 'step 2').should_not be_nil
       end
 

data/vendor/plugins/rspec/spec/spec_helper.rb

@@ -12,7 +12,11 @@ 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 Spec  
+  module Example
+    class NonStandardError < Exception; end
+  end
+
   module Matchers
     def fail
       raise_error(Spec::Expectations::ExpectationNotMetError)
@@ -22,82 +26,52 @@ module Spec
       raise_error(Spec::Expectations::ExpectationNotMetError, message)
     end
 
-    class Pass
-      def matches?(proc, &block)
-        begin
-          proc.call
-          true
-        rescue Exception => @error
-          false
-        end
-      end
-
-      def failure_message
-        @error.message + "\n" + @error.backtrace.join("\n")
+    def exception_from(&block)
+      exception = nil
+      begin
+        yield
+      rescue StandardError => e
+        exception = e
       end
-    end
-
-    def pass
-      Pass.new
+      exception
     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)
+    def run_with(options)
+      ::Spec::Runner::CommandLine.run(options)
     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
+def with_sandboxed_options
   attr_reader :options
+  
+  before(:each) do
+    @original_rspec_options = ::Spec::Runner.options
+    ::Spec::Runner.use(@options = ::Spec::Runner::Options.new(StringIO.new, StringIO.new))
+  end
 
-  before(:all) do
-    @original_rspec_options = $rspec_options
+  after(:each) do
+    ::Spec::Runner.use(@original_rspec_options)
   end
+  
+  yield
+end
 
+def with_sandboxed_config
+  attr_reader :config
+  
   before(:each) do
-    @options = ::Spec::Runner::Options.new(StringIO.new, StringIO.new)
-    $rspec_options = options
+    @config = ::Spec::Example::Configuration.new
+    @original_configuration = ::Spec::Runner.configuration
+    spec_configuration = @config
+    ::Spec::Runner.instance_eval {@configuration = spec_configuration}
   end
-
-  after do
-    $rspec_options = @original_rspec_options
+  
+  after(:each) do
+    original_configuration = @original_configuration
+    ::Spec::Runner.instance_eval {@configuration = original_configuration}
+    ::Spec::Example::ExampleGroupFactory.reset
   end
-end
+  
+  yield
+end

data/vendor/plugins/rspec/stories/all.rb

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

data/vendor/plugins/rspec/stories/configuration/before_blocks.story

@@ -0,0 +1,21 @@
+Story: before suite
+	As a developer using rspec
+	I want to define before blocks in the global configuration
+	So that I can define global things globally
+	
+	Scenario: running with ruby
+	
+		Given the file ../resources/spec/before_blocks_example.rb
+		
+    When I run it with the ruby interpreter
+
+		Then the stdout should match "3 examples, 0 failures"
+		
+	Scenario: running with spec
+
+		Given the file ../resources/spec/before_blocks_example.rb
+
+    When I run it with the spec script
+
+		Then the stdout should match "3 examples, 0 failures"
+					

data/vendor/plugins/rspec/stories/configuration/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/vendor/plugins/rspec/stories/mock_framework_integration/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/vendor/plugins/rspec/stories/mock_framework_integration/use_flexmock.story

@@ -0,0 +1,9 @@
+Story: Getting correct output with flexmock
+
+  As an RSpec user who prefers flexmock
+  I want to be able to use flexmock without rspec mocks interfering
+
+  Scenario: Mock with flexmock
+    Given the file spec/spec_with_flexmock.rb
+    When I run it with the ruby interpreter
+    Then the exit code should be 0

data/vendor/plugins/rspec/stories/resources/spec/before_blocks_example.rb

@@ -0,0 +1,32 @@
+$:.unshift File.join(File.dirname(__FILE__), *%w[.. .. .. lib])
+require 'spec'
+
+Spec::Runner.configure do |config|
+  config.before(:suite) do
+    $before_suite = "before suite"
+  end
+  config.before(:each) do
+    @before_each = "before each"
+  end
+  config.before(:all) do
+    @before_all = "before all"
+  end
+end
+
+describe "stuff in before blocks" do
+  describe "with :suite" do
+    it "should be available in the example" do
+      $before_suite.should == "before suite"
+    end
+  end
+  describe "with :all" do
+    it "should be available in the example" do
+      @before_all.should == "before all"
+    end
+  end
+  describe "with :each" do
+    it "should be available in the example" do
+      @before_each.should == "before each"
+    end
+  end
+end

data/vendor/plugins/rspec/stories/resources/spec/spec_with_flexmock.rb

@@ -0,0 +1,18 @@
+$:.push File.join(File.dirname(__FILE__), *%w[.. .. .. lib])
+require "rubygems"
+require 'spec'
+
+Spec::Runner.configure do |config|
+  config.mock_with :flexmock
+end
+
+# This is to ensure that requiring spec/mocks/framework doesn't interfere w/ flexmock
+require 'spec/mocks/framework'
+
+describe "something" do
+  it "should receive some message" do
+    target = Object.new
+    flexmock(target).should_receive(:foo).once
+    lambda {flexmock_verify}.should raise_error
+  end
+end

data/vendor/plugins/rspec/stories/stories/multiline_steps.story

@@ -0,0 +1,23 @@
+Story: multiline steps in plain text stories
+
+	As a plain text story writer
+	I want to write steps with multiline arguments
+	
+	Scenario: two lines
+	
+		Given I have a two line step with this text:
+		  This is the first line
+			# This, by the way, is just a comment
+			plus this is the second line
+
+			# This, by the way, is just a comment
+			
+		When I have a When with the same two lines:
+		  This is the first line
+			plus this is the second line
+			
+		Then it should match:
+ 	  	This is the first line
+			plus this is the second line
+			
+			# And here is another comment