spork 0.9.0.rc8-x86-mswin32

data/Gemfile

@@ -0,0 +1,10 @@
+source :gemcutter
+gem 'cucumber', '0.10.2'
+gem "rspec", "2.5.0"
+gem 'rake'
+
+if RUBY_VERSION =~ /^1\.9/
+  gem 'ruby-debug19'
+else
+  gem 'ruby-debug'
+end

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Tim Harper
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,134 @@
+= Spork
+
+* Repository: http://github.com/timcharper/spork
+* Issues: http://github.com/timcharper/spork/issues
+* Changes: http://github.com/timcharper/spork/blob/master/History.txt
+* Mailing list: http://groups.google.com/group/sporkgem
+* Wiki: http://wiki.github.com/timcharper/spork
+
+== SYNOPSIS:
+
+Spork is Tim Harper's implementation of test server (similar to the script/spec_server that used to be provided by rspec-rails), except rather than using the Rails constant unloading to reload your files, it forks a copy of the server each time you run your tests.  The result?  Spork runs more solid: it doesn't get corrupted over time, it can work with any ruby framework, and it properly handles modules and any voodoo meta programming you may have put in your app.
+
+Spork runs on POSIX systems using fork. It also runs on windows by pre-populating a pool of ready processes (referred to here as the "magazine" strategy).
+
+== Supported Testing Frameworks
+
+* Rspec
+* Cucumber
+* Test::Unit (via 'gem install spork-testunit')
+
+== Supported Application Frameworks
+
+Actually, Spork ~can~ work with any application framework.  But, it ships with hooks and helpers to make an "out of the box" experience.
+
+* Rails 3.0 (for Rails 2.{1,2,3}.x, please try spork 0.8.x)
+* Padrino
+
+== INSTALL:
+
+=== rubygems:
+
+  [sudo] gem install spork --prerelease
+
+(Rails 2.x)
+
+  [sudo] gem install spork --version 0.8.4
+
+=== bundler:
+
+Add to your Gemfile:
+
+  gem 'spork', '~> 0.9.0.rc'
+
+(Rails 2.x, use this)
+
+  gem 'spork', '~> 0.8'
+
+== Usage
+
+From a terminal, change to your project directory.
+
+Then, bootstrap your spec/spec_helper.rb file.
+
+  spork --bootstrap
+
+Next, edit spec/spec_helper.rb and follow the instructions that were put at the top.
+
+Finally, run spork.  A spec DRb server will be running!
+
+  spork
+
+== Diagnostic mode
+
+Initially, you may find that a few files don't reload automatically.  This is because they are being loaded during Spork startup.  To identify which project files are being pre-loaded, and why, run:
+
+  spork --diagnose | less
+  (or spork -d, for short)
+
+It will output a lot of stuff.  At the top you'll find a summary of all project files loaded.  Down below, the stack trace for each file (how it got loaded).  Spork hooks into Rails and does some magic (TM) to prevent ApplicationController observers, etc from pre-loading.  Similar hooks for other ruby frameworks may come as support demands.
+
+Some project changes will require a spork restart, and you shouldn't expect them to not (IE: modifying your project gem dependencies or core application config).  Any file that is loaded during Spork start-up will be cached until Spork is restarted.  You can restart spork by sending a USR2 signal to the server process.  This could be automated with a gem such as Kicker (https://github.com/alloy/kicker).  Since a native hook is required for each operating system to efficiently watch for filesystem changes, automatic restarting has not been built into Spork.
+
+You may find this wiki page useful for common ways to battle a variety of common pre-loading issues: http://github.com/timcharper/spork/wiki/Spork.trap_method-Jujutsu
+
+== Running specs over Spork
+
+=== RSpec
+
+To get the TextMate RSpec bundle to use spork, go to config->advanced->shell variables, and add:
+
+  TM_RSPEC_OPTS=--drb.
+
+To run from the command line, use:
+
+  rspec --drb spec/lib/my_spec.rb
+
+Or, you could add the following flag to your +spec.opts+ (or +.rspec+ depending on your version of rspec) file.
+
+  --drb
+
+=== Cucumber
+
+Cucumber has DRb support (see http://wiki.github.com/cucumber/cucumber/spork-and---drb)
+
+  cucumber --drb features/my.feature
+
+Use this as a guideline when "Sporking" your features/support/env.rb file
+
+  http://gist.github.com/123370
+
+== Running the Spork test suite
+
+If you wish to hack on spork, you will want to run the automated test suite to make sure your changes don't break anything.  Spork uses bundler to manage and install dependencies.  To start:
+
+  bundle install
+
+Then, to run the specs:
+
+  bundle exec rspec spec/
+
+(or, alternatively...)
+
+  bundle exec rake
+
+=== running features ===
+
+Essentially:
+
+  bundle exec cucumber features
+
+== Some potential issues and ways to overcome them:
+
+See http://wiki.github.com/timcharper/spork/troubleshooting
+
+== Kudos to
+
+* Ben Mabey - help with documentation, testing, suggestions, patches, and bringing Cucumber support.
+* David Chelimsky - for the fine RSpec testing framework, and the original rspec-rails spec_server implementation, which Spork has built upon.
+* LeadTune - just for being an awesome place to work.
+* Alan Aslak - for the fine Cucumber testing framework, and for much collaboration getting cucumber working with spork.
+* Roger Pack - JRuby support / Windows
+* Donald Parish - Windows support (Magazine strategy)
+
+Spork (c) 2011 Tim Harper, released under the MIT license

data/assets/bootstrap.rb

@@ -0,0 +1,47 @@
+require 'rubygems'
+require 'spork'
+
+Spork.prefork do
+  # Loading more in this block will cause your tests to run faster. However,
+  # if you change any configuration or code from libraries loaded here, you'll
+  # need to restart spork for it take effect.
+
+end
+
+Spork.each_run do
+  # This code will be run each time you run your specs.
+
+end
+
+# --- Instructions ---
+# Sort the contents of this file into a Spork.prefork and a Spork.each_run
+# block.
+#
+# The Spork.prefork block is run only once when the spork server is started.
+# You typically want to place most of your (slow) initializer code in here, in
+# particular, require'ing any 3rd-party gems that you don't normally modify
+# during development.
+#
+# The Spork.each_run block is run each time you run your specs.  In case you
+# need to load files that tend to change during development, require them here.
+# With Rails, your application modules are loaded automatically, so sometimes
+# this block can remain empty.
+#
+# Note: You can modify files loaded *from* the Spork.each_run block without
+# restarting the spork server.  However, this file itself will not be reloaded,
+# so if you change any of the code inside the each_run block, you still need to
+# restart the server.  In general, if you have non-trivial code in this file,
+# it's advisable to move it into a separate file so you can easily edit it
+# without restarting spork.  (For example, with RSpec, you could move
+# non-trivial code into a file spec/support/my_helper.rb, making sure that the
+# spec/support/* files are require'd from inside the each_run block.)
+#
+# Any code that is left outside the two blocks will be run during preforking
+# *and* during each_run -- that's probably not what you want.
+#
+# These instructions should self-destruct in 10 seconds.  If they don't, feel
+# free to delete them.
+
+
+
+

data/bin/spork

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../lib') unless $LOAD_PATH.include?(File.dirname(__FILE__) + '/../lib')
+
+require 'spork'
+require 'spork/runner'
+
+begin
+  success = Spork::Runner.run(ARGV, STDOUT, STDERR)
+  Kernel.exit(success ? 0 : 1)
+rescue SystemExit => e
+  Kernel.exit(e.status)
+rescue Exception => e
+  STDERR.puts("#{e.message} (#{e.class})")
+  STDERR.puts(e.backtrace.join("\n"))
+  Kernel.exit 1
+end
+
+

data/features/at_exit_during_each_run.feature

@@ -0,0 +1,36 @@
+Feature: At exit during each run
+  In order to make sure at_exit hooks defined during the run get called
+  I want to override kernel #at_exit
+
+  Scenario: at exit
+
+    Given a file named "spec/spec_helper.rb" with:
+      """
+      require 'rubygems'
+      require 'rspec'
+      Spork.prefork do
+        puts "loading"
+        at_exit { puts "prefork at_exit called" }
+      end
+
+      Spork.each_run do
+        puts "running"
+        at_exit { printf "first " }
+        at_exit { printf "second " }
+      end
+
+      """
+
+    And a file named "spec/did_it_work_spec.rb" with:
+      """
+      require 'spec_helper'
+      describe "Did it work?" do
+        it "checks to see if all worked" do
+          puts "ran specs"
+        end
+      end
+      """
+    When I fire up a spork instance with "spork rspec"
+    And I run rspec --drb spec/did_it_work_spec.rb
+    Then the output should contain "second first"
+    Then the output should not contain "prefork at_exit called"

data/features/cucumber_rails_integration.feature

@@ -0,0 +1,107 @@
+Feature: Cucumber integration with rails
+  As a developer using cucumber and rails
+  I want to use Spork with Cucumber
+  In order to eliminate the startup cost of my application each time I run them
+  
+  Background: Sporked env.rb
+    Given I am in a fresh rails project named "test_rails_project"
+    And the application has a model, observer, route, and application helper
+    And a file named "features/support/env.rb" with:
+      """
+      require 'rubygems'
+      require 'spork'
+      ENV["RAILS_ENV"] ||= "test"
+
+
+      Spork.prefork do
+        # Loading more in this block will cause your tests to run faster. However, 
+        # if you change any configuration or code from libraries loaded here, you'll
+        # need to restart spork for it take effect.
+        
+        # Sets up the Rails environment for Cucumber
+        require File.expand_path(File.dirname(__FILE__) + '/../../config/environment')
+
+        require 'cucumber'
+        require 'cucumber/formatter/unicode' # Comment out this line if you don't want Cucumber Unicode support
+        require 'rspec/rails'
+        require 'cucumber/rails/rspec'
+        
+        #### this is for this test only #######
+        $loaded_stuff << 'prefork block' ######
+        #######################################
+      end
+
+      Spork.each_run do
+        #### this is for this test only #######
+        $loaded_stuff << 'each_run block' #####
+        #######################################
+      end
+      """
+    And a file named "features/cucumber_rails.feature" with:
+      """
+      Feature: cucumber rails
+        Scenario: did it work?
+          Then it should work
+
+        Scenario: did it work again?
+          Then it should work
+      """
+    And a file named "features/support/cucumber_rails_helper.rb" with:
+      """
+      $loaded_stuff << 'features/support/cucumber_rails_helper.rb'
+      """
+    And a file named "config/database.yml" with:
+      """
+      test:
+        adapter: sqlite3
+        database: db/test.sqlite3
+        timeout: 5000
+      """
+    And a file named "features/step_definitions/cucumber_rails_steps.rb" with:
+      """
+      Then "it should work" do
+        (Rails.respond_to?(:logger) ? Rails.logger : ActionController::Base.logger).info "hey there"
+        $loaded_stuff.should include('ActiveRecord::Base.establish_connection')
+        $loaded_stuff.should include('User')
+        $loaded_stuff.should include('UserObserver')
+        $loaded_stuff.should include('ApplicationHelper')
+        $loaded_stuff.should include('config/routes.rb')
+        $loaded_stuff.should include('features/support/cucumber_rails_helper.rb')
+        $loaded_stuff.should include('each_run block')
+        $loaded_stuff.should include('prefork block')
+        puts "It worked!"
+      end
+      
+      Alors /ca marche/ do
+      end
+      """
+    Scenario: Analyzing files were preloaded
+      When I run spork --diagnose
+      Then the output should not contain "user_observer.rb"
+      Then the output should not contain "user.rb"
+      Then the output should not contain "app/controllers/application.rb"
+      Then the output should not contain "app/controllers/application_controller.rb"
+      Then the output should not contain "app/controllers/application_helper.rb"
+      Then the output should not contain "features/step_definitions/cucumber_rails_steps.rb"
+      Then the output should not contain "features/support/cucumber_rails_helper.rb"
+      
+    Scenario: Running spork with a rails app and no server
+      When I run cucumber --drb features
+      Then the error output should contain
+        """
+        WARNING: No DRb server is running. Running features locally
+        """
+
+    Scenario: Running spork with a rails app and observers
+      When I fire up a spork instance with "spork cucumber"
+      And I run cucumber --drb features
+      Then the error output should be empty
+      And the output should contain "It worked!"
+      And the file "log/test.log" should include "hey there"
+      
+    Scenario: Running spork with a rails app and a non-standard port
+      When I fire up a spork instance with "spork cucumber -p 9000"
+      And I run cucumber --drb --port 9000 features
+      Then the error output should be empty
+      And the output should contain "It worked!"
+      And the file "log/test.log" should include "hey there"

data/features/diagnostic_mode.feature

@@ -0,0 +1,41 @@
+Feature: Diagnostic Mode
+  To help a developer quickly pinpoint why files are being loaded
+  Spork provides a diagnostic mode
+  That provides a list of which project files were loaded during prefork, and who loaded them.
+
+  Scenario: Running spork --diagnose
+    Given I am in the directory "test_project"
+    And a file named "spec/spec_helper.rb" with:
+      """
+      require 'rubygems'
+      require 'spork'
+
+      Spork.prefork do
+        require 'lib/awesome.rb'
+        require '../external_dependency/super_duper.rb'
+      end
+
+      Spork.each_run do
+        puts "I'm loading the stuff just for this run..."
+      end
+      """
+    And a file named "lib/awesome.rb" with:
+      """
+      class Awesome
+      end
+      """
+    And a file named "../external_dependency/super_duper.rb" with:
+      """
+      class Awesome
+      end
+      """
+    When I run spork --diagnose
+    Then the error output should contain
+      """
+      Loading Spork.prefork block...
+      """
+    And the output should contain "lib/awesome.rb"
+    And the output should contain "spec/spec_helper.rb:5"
+    And the output should not contain "super_duper.rb"
+    And the output should not contain "diagnose.rb"
+     

data/features/gemfiles/rails3.0/Gemfile

@@ -0,0 +1,14 @@
+source :gemcutter
+gem 'sqlite3-ruby', '1.2.5'
+gem 'cucumber', '0.10.2'
+gem 'cucumber-rails', '0.4.1'
+gem "rspec", "2.5.0"
+gem 'rspec-rails', "2.5.0"
+gem 'rails', '3.0.7'
+
+if RUBY_VERSION =~ /^1\.9/
+  gem 'ruby-debug19'
+else
+  gem 'ruby-debug', '>= 0.10.3'
+end
+gem 'spork', :path => File.expand_path("../../..", File.dirname(__FILE__))

data/features/gemfiles/rails3.0/Gemfile.lock

@@ -0,0 +1,120 @@
+PATH
+  remote: /Users/timcharper/projects/spork
+  specs:
+    spork (0.9.0.rc7)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    abstract (1.0.0)
+    actionmailer (3.0.7)
+      actionpack (= 3.0.7)
+      mail (~> 2.2.15)
+    actionpack (3.0.7)
+      activemodel (= 3.0.7)
+      activesupport (= 3.0.7)
+      builder (~> 2.1.2)
+      erubis (~> 2.6.6)
+      i18n (~> 0.5.0)
+      rack (~> 1.2.1)
+      rack-mount (~> 0.6.14)
+      rack-test (~> 0.5.7)
+      tzinfo (~> 0.3.23)
+    activemodel (3.0.7)
+      activesupport (= 3.0.7)
+      builder (~> 2.1.2)
+      i18n (~> 0.5.0)
+    activerecord (3.0.7)
+      activemodel (= 3.0.7)
+      activesupport (= 3.0.7)
+      arel (~> 2.0.2)
+      tzinfo (~> 0.3.23)
+    activeresource (3.0.7)
+      activemodel (= 3.0.7)
+      activesupport (= 3.0.7)
+    activesupport (3.0.7)
+    arel (2.0.9)
+    builder (2.1.2)
+    columnize (0.3.2)
+    cucumber (0.10.2)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.2)
+      gherkin (>= 2.3.5)
+      json (>= 1.4.6)
+      term-ansicolor (>= 1.0.5)
+    cucumber-rails (0.4.1)
+      cucumber (>= 0.10.1)
+      nokogiri (>= 1.4.4)
+      rack-test (>= 0.5.7)
+    diff-lcs (1.1.2)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    gherkin (2.3.7)
+      json (>= 1.4.6)
+    i18n (0.5.0)
+    json (1.5.1)
+    linecache (0.43)
+    mail (2.2.19)
+      activesupport (>= 2.3.6)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.16)
+    nokogiri (1.4.4)
+    polyglot (0.3.1)
+    rack (1.2.2)
+    rack-mount (0.6.14)
+      rack (>= 1.0.0)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rails (3.0.7)
+      actionmailer (= 3.0.7)
+      actionpack (= 3.0.7)
+      activerecord (= 3.0.7)
+      activeresource (= 3.0.7)
+      activesupport (= 3.0.7)
+      bundler (~> 1.0)
+      railties (= 3.0.7)
+    railties (3.0.7)
+      actionpack (= 3.0.7)
+      activesupport (= 3.0.7)
+      rake (>= 0.8.7)
+      thor (~> 0.14.4)
+    rake (0.8.7)
+    rspec (2.5.0)
+      rspec-core (~> 2.5.0)
+      rspec-expectations (~> 2.5.0)
+      rspec-mocks (~> 2.5.0)
+    rspec-core (2.5.2)
+    rspec-expectations (2.5.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.5.0)
+    rspec-rails (2.5.0)
+      actionpack (~> 3.0)
+      activesupport (~> 3.0)
+      railties (~> 3.0)
+      rspec (~> 2.5.0)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+    sqlite3-ruby (1.2.5)
+    term-ansicolor (1.0.5)
+    thor (0.14.6)
+    treetop (1.4.9)
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.27)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  cucumber (= 0.10.2)
+  cucumber-rails (= 0.4.1)
+  rails (= 3.0.7)
+  rspec (= 2.5.0)
+  rspec-rails (= 2.5.0)
+  ruby-debug (>= 0.10.3)
+  spork!
+  sqlite3-ruby (= 1.2.5)