wakiki-spork 0.8.5

data/spec/spork/forker_spec.rb

@@ -0,0 +1,44 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Spork::Forker do
+  describe ".new" do
+    it "runs a block in a fork" do
+      $var = "hello world"
+      Spork::Forker.new { $var = "booyah" }.result
+      $var.should == "hello world"
+    end
+  end
+  
+  describe "#result" do
+    it "returns the result" do
+      Spork::Forker.new { "results" }.result.should == "results"
+    end
+  end
+  
+  describe "#running?" do
+    it "reports when the fork is running" do
+      forker = Spork::Forker.new { sleep 0.1 }
+      forker.running?.should == true
+      forker.result
+      sleep 0.1
+      forker.running?.should == false
+    end
+  end
+  
+  describe "#abort" do
+    it "aborts a fork and returns nil for the result" do
+      started_at = Time.now
+      ended_at = nil
+      forker = Spork::Forker.new { sleep 5 }
+      Thread.new do
+        forker.result.should == nil
+        ended_at = Time.now
+      end
+      sleep 0.5
+      forker.abort
+      sleep 0.1
+      (ended_at - started_at).should be_close(0.5, 0.1)
+      forker.running?.should == false
+    end
+  end
+end

data/spec/spork/run_strategy/forking_spec.rb

@@ -0,0 +1,38 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+describe Spork::RunStrategy::Forking do
+  before(:each) do
+    @fake_framework = FakeFramework.new
+    @run_strategy = Spork::RunStrategy::Forking.new(@fake_framework)
+
+  end
+
+  it "returns the result of the run_tests method from the forked child" do
+    create_helper_file
+    @fake_framework.stub!(:run_tests).and_return("tests were ran")
+    @run_strategy.run("test", STDOUT, STDIN).should == "tests were ran"
+  end
+
+  it "aborts the current running thread when another run is started" do
+    create_helper_file
+    @fake_framework.wait_time = 0.25
+    first_run = Thread.new { @run_strategy.run("test", STDOUT, STDIN).should == nil }
+    sleep(0.05)
+    @run_strategy.run("test", STDOUT, STDIN).should == true
+
+    # wait for the first to finish
+    first_run.join
+  end
+
+  it "can abort the current run" do
+    create_helper_file
+    @fake_framework.wait_time = 5
+    started_at = Time.now
+    first_run = Thread.new { @run_strategy.run("test", STDOUT, STDIN).should == true }
+    sleep(0.05)
+    @run_strategy.send(:abort)
+    sleep(0.01) while @run_strategy.running?
+
+    (Time.now - started_at).should < @fake_framework.wait_time
+  end
+end

data/spec/spork/runner_spec.rb

@@ -0,0 +1,50 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Spork::Runner do
+  def use_test_server(klass = Spork::TestFramework::RSpec)
+    @test_framework = klass.new
+    Spork::TestFramework.stub!(:factory).and_return(@test_framework)
+  end
+
+  before(:each) do
+    @out, @err = StringIO.new, StringIO.new
+  end
+  
+  it "finds a matching server with a prefix" do
+    Spork::Runner.new(["rs"], @out, @err).find_test_framework.class.should == Spork::TestFramework::RSpec
+  end
+  
+  it "shows an error message if no matching server was found" do
+    Spork::Runner.new(["argle_bargle"], @out, @err).run.should == false
+    @err.string.should include(%(Couldn't find a supported test framework that begins with 'argle_bargle'))
+  end
+  
+  it "bootstraps a server when -b is passed in" do
+    use_test_server
+    @test_framework.should_receive(:bootstrap)
+    Spork::Runner.new(['rspec', '-b'], @out, @err).run
+  end
+  
+  it "aborts if it can't preload" do
+    use_test_server
+    @test_framework.should_receive(:preload).and_return(false)
+    Spork::Server.should_not_receive(:run)
+    Spork::Runner.new(['rspec'], @out, @err).run
+  end
+  
+  it "runs the server if all is well" do
+    use_test_server
+    @test_framework.should_receive(:preload).and_return(true)
+    Spork::Server.should_receive(:run)
+    Spork::Runner.new(['rspec'], @out, @err).run
+    @err.string.should include("Using RSpec")
+  end
+  
+  it "outputs a list of supported servers, along with supported asterisk" do
+    Spork::Server.stub!(:supported_test_frameworks).and_return([Spork::TestFramework::RSpec, Spork::TestFramework::Cucumber])
+    Spork::TestFramework::RSpec.stub!(:available?).and_return(true)
+    Spork::TestFramework::Cucumber.stub!(:available?).and_return(false)
+    
+    Spork::Runner.new(['rspec'], @out, @err).supported_test_frameworks_text.should include("(*) RSpec")
+  end
+end

data/spec/spork/server_spec.rb

@@ -0,0 +1,15 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Spork::Server do
+  describe "a fake server" do
+    before(:each) do
+      @fake_run_strategy = FakeRunStrategy.new
+      @server = Spork::Server.new(:run_strategy => @fake_run_strategy)
+    end
+    
+    it "accepts a port" do
+      @server.port = 12345
+      @server.port.should == 12345
+    end
+  end
+end

data/spec/spork/test_framework/cucumber_spec.rb

@@ -0,0 +1,11 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require File.dirname(__FILE__) + "/../test_framework_spec"
+
+describe Spork::TestFramework::Cucumber do
+  before(:each) do
+    @klass = Spork::TestFramework::Cucumber
+    @server = @klass.new
+  end
+
+  it_should_behave_like "a TestFramework"
+end

data/spec/spork/test_framework/rspec_spec.rb

@@ -0,0 +1,10 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+require File.dirname(__FILE__) + "/../test_framework_spec"
+
+describe Spork::TestFramework::RSpec do
+  before(:each) do
+    @klass = Spork::TestFramework::RSpec
+  end
+
+  it_should_behave_like "a TestFramework"
+end

data/spec/spork/test_framework_spec.rb

@@ -0,0 +1,114 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe "a TestFramework", :shared => true do
+  describe ".default_port" do
+    it "uses the DEFAULT_PORT when the environment variable is not set" do
+      @klass.default_port.should == @klass::DEFAULT_PORT
+    end
+
+    it 'uses ENV["#{short_name.upcase}_DRB"] as port if present' do
+      env_name = "#{@klass.short_name.upcase}_DRB"
+      orig, ENV[env_name] = ENV[env_name], "9000"
+      begin
+        @klass.default_port.should == 9000
+      ensure
+        ENV[env_name] = orig
+      end
+    end
+  end
+
+  describe ".helper_file" do
+    it "returns ::HELPER_FILE for the TestFramework" do
+      @klass.helper_file.should == @klass::HELPER_FILE
+    end
+  end
+end
+
+describe Spork::TestFramework do
+
+  before(:each) do
+    @fake = FakeFramework.new
+  end
+
+  describe ".available_test_frameworks" do
+    before(:each) do
+      Spork::TestFramework.supported_test_frameworks.each { |s| s.stub!(:available?).and_return(false) }
+    end
+
+    it "returns a list of all available servers" do
+      Spork::TestFramework.available_test_frameworks.should == []
+      Spork::TestFramework::RSpec.stub!(:available?).and_return(true)
+      Spork::TestFramework.available_test_frameworks.should == [Spork::TestFramework::RSpec]
+    end
+
+    it "returns rspec before cucumber when both are available" do
+      Spork::TestFramework::RSpec.stub!(:available?).and_return(true)
+      Spork::TestFramework::Cucumber.stub!(:available?).and_return(true)
+      Spork::TestFramework.available_test_frameworks.should == [Spork::TestFramework::RSpec, Spork::TestFramework::Cucumber]
+    end
+  end
+
+  describe ".supported_test_frameworks" do
+    it "returns all defined servers" do
+      Spork::TestFramework.supported_test_frameworks.should include(Spork::TestFramework::RSpec)
+      Spork::TestFramework.supported_test_frameworks.should include(Spork::TestFramework::Cucumber)
+    end
+
+    it "returns a list of servers matching a case-insensitive prefix" do
+      Spork::TestFramework.supported_test_frameworks("rspec").should == [Spork::TestFramework::RSpec]
+      Spork::TestFramework.supported_test_frameworks("rs").should == [Spork::TestFramework::RSpec]
+      Spork::TestFramework.supported_test_frameworks("cuc").should == [Spork::TestFramework::Cucumber]
+    end
+  end
+
+  describe ".short_name" do
+    it "returns the name of the framework, without the namespace prefix" do
+      Spork::TestFramework::Cucumber.short_name.should == "Cucumber"
+    end
+  end
+
+  describe ".available?" do
+    it "returns true when the helper_file exists" do
+      FakeFramework.available?.should == false
+      create_helper_file(FakeFramework)
+      FakeFramework.available?.should == true
+    end
+  end
+
+  describe ".bootstrapped?" do
+    it "recognizes if the helper_file has been bootstrapped" do
+      bootstrap_contents = File.read(FakeFramework::BOOTSTRAP_FILE)
+      File.stub!(:read).with(@fake.helper_file).and_return("")
+      @fake.bootstrapped?.should == false
+      File.stub!(:read).with(@fake.helper_file).and_return(bootstrap_contents)
+      @fake.bootstrapped?.should == true
+    end
+  end
+
+  describe ".bootstrap" do
+    it "bootstraps a file" do
+      create_helper_file
+      @fake.bootstrap
+
+      $test_stderr.string.should include("Bootstrapping")
+      $test_stderr.string.should include("Edit")
+      $test_stderr.string.should include("favorite text editor")
+
+      File.read(@fake.helper_file).should include(File.read(FakeFramework::BOOTSTRAP_FILE))
+    end
+  end
+
+  describe ".factory" do
+    it "defaults to use rspec over cucumber" do
+      Spork::TestFramework::RSpec.stub!(:available?).and_return(true)
+      Spork::TestFramework::Cucumber.stub!(:available?).and_return(true)
+      Spork::TestFramework.factory(STDOUT, STDERR).class.should == Spork::TestFramework::RSpec
+    end
+
+    it "defaults to use cucumber when rspec not available" do
+      Spork::TestFramework::RSpec.stub!(:available?).and_return(false)
+      Spork::TestFramework::Cucumber.stub!(:available?).and_return(true)
+      Spork::TestFramework.factory(STDOUT, STDERR).class.should == Spork::TestFramework::Cucumber
+    end
+  end
+end

data/spec/spork_spec.rb

@@ -0,0 +1,151 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+Spork.class_eval do
+  def self.reset!
+    @state = nil
+    @already_ran = nil
+  end
+end
+
+describe Spork do
+  before(:each) do
+    Spork.reset!
+  end
+  
+  def spec_helper_simulator
+    @ran ||= []
+    Spork.prefork do
+      @ran << :prefork
+    end
+    
+    Spork.each_run do
+      @ran << :each_run
+    end
+    @ran
+  end
+  
+  it "only runs the preload block when preforking" do
+    Spork.exec_prefork { spec_helper_simulator }
+    @ran.should == [:prefork]
+  end
+  
+  it "only runs the each_run block when running" do
+    Spork.exec_prefork { spec_helper_simulator }
+    @ran.should == [:prefork]
+    
+    Spork.exec_each_run
+    @ran.should == [:prefork, :each_run]
+  end
+  
+  it "runs both blocks when Spork not activated" do
+    spec_helper_simulator.should == [:prefork, :each_run]
+  end
+  
+  it "prevents blocks from being ran twice" do
+    Spork.exec_prefork { spec_helper_simulator }
+    Spork.exec_each_run
+    @ran.clear
+    Spork.exec_prefork { spec_helper_simulator }
+    Spork.exec_each_run
+    @ran.should == []
+  end
+  
+  it "runs multiple prefork and each_run blocks at different locations" do
+    Spork.prefork { }
+    Spork.each_run { }
+    spec_helper_simulator.should == [:prefork, :each_run]
+  end
+  
+  it "expands a caller line, preserving the line number" do
+    Spork.send(:expanded_caller, "/boo/../yah.rb:31").should == "/yah.rb:31"
+  end
+  
+  describe "#using_spork?" do
+    it "returns true if Spork is being used" do
+      Spork.using_spork?.should be_false
+      Spork.using_spork!
+      Spork.using_spork?.should be_true
+    end
+  end
+
+  describe "#trap_method" do
+    before(:each) do
+      Spork.using_spork!
+      
+      Object.class_eval do
+        class TrapTest
+          def self.output
+            @output ||= []
+          end
+          
+          def hello
+            TrapTest.output << 'hello'
+          end
+          
+          def goodbye
+            TrapTest.output << 'goodbye'
+          end
+          
+          def say_something!
+            TrapTest.output << 'something'
+          end
+        end
+      end
+      @trap_test = TrapTest.new
+    end
+    
+    after(:each) do
+      Object.send(:remove_const, :TrapTest)
+    end
+    
+    it "delays execution of a method until after Spork.exec_each_run is called" do
+      Spork.using_spork!
+      Spork.trap_method(TrapTest, :hello)
+      @trap_test.hello
+      @trap_test.goodbye
+      Spork.exec_each_run
+      TrapTest.output.should == ['goodbye', 'hello']
+    end
+    
+    it "works with methods that have punctuation" do
+      Spork.trap_method(TrapTest, :say_something!)
+      @trap_test.say_something!
+      TrapTest.output.should == []
+      Spork.exec_each_run
+      TrapTest.output.should == ['something']
+    end
+  end
+  
+  describe "#trap_class_method" do
+    before(:each) do
+      Object.class_eval do
+        class TrapTest
+          def self.output
+            @output ||= []
+          end
+          
+          def self.hello
+            output << 'hello'
+          end
+          
+          def self.goodbye
+            output << 'goodbye'
+          end
+        end
+      end
+    end
+    
+    after(:each) do
+      Object.send(:remove_const, :TrapTest)
+    end
+    
+    it "delays execution of a method until after Spork.exec_each_run is called" do
+      Spork.using_spork!
+      Spork.trap_class_method(TrapTest, :hello)
+      TrapTest.hello
+      TrapTest.goodbye
+      Spork.exec_each_run
+      TrapTest.output.should == ['goodbye', 'hello']
+    end
+  end
+end

data/spec/support/fake_framework.rb

@@ -0,0 +1,15 @@
+class FakeFramework < Spork::TestFramework
+  include Spork::TestIOStreams
+
+  attr_accessor :wait_time
+  DEFAULT_PORT = 1000
+
+  def self.helper_file
+    SPEC_TMP_DIR + "/fake/test_helper.rb"
+  end
+
+  def run_tests(argv, input, output)
+    sleep(@wait_time || 0.5)
+    true
+  end
+end