spork 0.9.0.rc8-x86-mingw32

data/spec/spork/app_framework_spec.rb

@@ -0,0 +1,16 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe Spork::AppFramework do
+  describe ".detect_framework" do
+    it "detects when rails is installed and available" do
+      create_file("config/environment.rb", "RAILS_GEM_VERSION = '2.1.0'")
+      in_current_dir do
+        Spork::AppFramework.detect_framework.short_name.should == "Rails"
+      end
+    end
+  
+    it "returns Unknown when no framework known detected" do
+      Spork::AppFramework.detect_framework.short_name.should == "Unknown"
+    end
+  end
+end

data/spec/spork/diagnoser_spec.rb

@@ -0,0 +1,105 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+
+describe Spork::Diagnoser do
+  after(:each) do
+    Spork::Diagnoser.remove_hook!
+    Spork::Diagnoser.loaded_files.clear
+  end
+  
+  def run_simulation(directory, filename = nil, contents = nil, &block)
+    FileUtils.mkdir_p(directory)
+    Dir.chdir(directory) do
+      if filename
+        File.open(filename, 'wb') { |f| f << contents }
+        Spork::Diagnoser.install_hook!
+        require "./#{filename}"
+      end
+      yield if block_given?
+    end
+  end
+  
+  it "installs it's hook and tells you when files have been loaded" do
+    run_simulation(SPEC_TMP_DIR, 'my_awesome_library_include.rb', '1 + 5')
+    Spork::Diagnoser.loaded_files.keys.should include_a_string_like('my_awesome_library_include')
+  end
+
+  it 'excludes files outside of Dir.pwd' do
+    run_simulation(SPEC_TMP_DIR + '/project_root', '../external_dependency.rb', '1 + 5')
+    Spork::Diagnoser.loaded_files.keys.should_not include_a_string_like('external_dependency')
+  end
+  
+  it "excludes files outside of Dir.pwd but in ruby's include path" do
+    directory = SPEC_TMP_DIR + '/project_root'
+    external_dependency_dir = SPEC_TMP_DIR + '/external_dependency'
+    $: << external_dependency_dir
+    FileUtils.mkdir_p(directory)
+    FileUtils.mkdir_p(external_dependency_dir)
+    Dir.chdir(directory) do
+      File.open(external_dependency_dir + '/the_most_awesome_external_dependency_ever.rb', 'wb') { |f| f << 'funtimes = true' }
+      Spork::Diagnoser.install_hook!
+      require 'the_most_awesome_external_dependency_ever'
+    end
+    
+    Spork::Diagnoser.loaded_files.keys.should_not include_a_string_like('the_most_awesome_external_dependency_ever')
+    $:.pop
+  end
+  
+  it "expands files to their fully their fully qualified path" do
+    directory = SPEC_TMP_DIR + '/project_root'
+    lib_directory = directory + '/lib'
+    $: << lib_directory
+    FileUtils.mkdir_p(lib_directory)
+    Dir.chdir(directory) do
+      File.open(lib_directory + "/the_most_awesome_lib_file_ever.rb", "wb") { |f| f << "funtimes = true" }
+      Spork::Diagnoser.install_hook!
+      require 'the_most_awesome_lib_file_ever'
+    end
+    
+    Spork::Diagnoser.loaded_files.keys.should include_a_string_like('lib/the_most_awesome_lib_file_ever')
+    $:.pop
+  end
+  
+  it "can tell the difference between a folder in the project path and a file in an external path" do
+    directory = SPEC_TMP_DIR + '/project_root'
+    external_dependency_dir = SPEC_TMP_DIR + '/external_dependency'
+    $: << external_dependency_dir
+    FileUtils.mkdir_p(directory)
+    FileUtils.mkdir_p(external_dependency_dir)
+    Dir.chdir(directory) do
+      FileUtils.mkdir_p(directory + '/a_popular_folder_name')
+      File.open(external_dependency_dir + '/a_popular_folder_name.rb', 'wb') { |f| f << 'funtimes = true' }
+      Spork::Diagnoser.install_hook!
+      require 'a_popular_folder_name'
+    end
+    
+    Spork::Diagnoser.loaded_files.keys.should_not include_a_string_like('a_popular_folder_name')
+    $:.pop
+  end
+  
+  it "filters backtrace beyond the last line matching the entry point" do
+    Spork::Diagnoser.install_hook!("test_filter/environment.rb")
+    create_file("test_filter/environment.rb", "require './test_filter/app.rb'")
+    create_file("test_filter/app.rb", "require './test_filter/my_model.rb'")
+    create_file("test_filter/my_model.rb", "'my model here'")
+    in_current_dir do
+      require './test_filter/environment.rb'
+    end
+    f = Spork::Diagnoser.loaded_files
+    f[f.keys.grep(/app.rb/).first].last.should include('test_filter/environment.rb')
+    f[f.keys.grep(/my_model.rb/).first].last.should include('test_filter/environment.rb')
+    f[f.keys.grep(/environment.rb/).first].should == []
+  end
+  
+  describe ".output_results" do
+    it "outputs the results relative to the current directory" do
+      Spork::Diagnoser.loaded_files["/project_path/lib/file.rb"] = ["/project_path/lib/parent_file.rb:35"]
+      Dir.stub!(:pwd).and_return("/project_path")
+      out = StringIO.new
+      Spork::Diagnoser.output_results(out)
+      out.string.should =~ %r([^/]lib/file.rb)
+      out.string.should =~ %r([^/]lib/parent_file.rb)
+      out.string.should_not include("/project_path/")
+    end
+  end
+end

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 unless windows?

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 unless windows?

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_shared_examples"
+
+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_shared_examples"
+
+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_shared_examples.rb

@@ -0,0 +1,23 @@
+shared_examples_for "a TestFramework" 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

data/spec/spork/test_framework_spec.rb

@@ -0,0 +1,90 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+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,153 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+Spork.class_eval do
+  def self.reset!
+    @state = nil
+    @using_spork = false
+    @already_ran = nil
+    @each_run_procs = nil
+  end
+end
+
+describe Spork do
+  before(:each) do
+    Spork.reset!
+    @ran = []
+  end
+  
+  def spec_helper_simulator
+    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.exec_prefork { }
+      Spork.using_spork?.should be_true
+    end
+  end
+
+  describe "#trap_method" do
+    before(:each) do
+      Spork.exec_prefork { }
+      
+      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.exec_prefork { }
+      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.exec_prefork { }
+      Spork.trap_class_method(TrapTest, :hello)
+      TrapTest.hello
+      TrapTest.goodbye
+      Spork.exec_each_run
+      TrapTest.output.should == ['goodbye', 'hello']
+    end
+  end
+end