milhouse-spork 0.7.5

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,100 @@
+= 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 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, and it properly handles modules and any voo-doo meta programming you may have put in your app.
+
+Because Spork uses Kernel.fork, it only works on POSIX systems.  This means Windows users are not invited to this party.  Sorry :(
+
+== Supported Testing Frameworks
+
+* Rspec
+* Cucumber
+
+And more to come!  Vote for your favorite at http://github.com/timcharper/spork/issues
+
+== Supported Application Frameworks
+
+Actually, Spork ~can~ work with any application framework.  But, it ships with hooks and helpers to help make the experience much more "out of the box"
+
+* Rails
+
+More can be added!  Vote for your favorite at http://github.com/timcharper/spork/issues
+
+== INSTALL:
+
+  [sudo] gem install spork
+
+alternatively:
+
+  git clone git://github.com/timcharper/spork.git
+  cd spork
+  gem build spork.gemspec
+  sudo gem install spork.gemspec
+
+== 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
+  (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.
+
+== 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:
+
+  spec --drb spec/lib/my_spec.rb
+
+Or, you could add the following flag to your +spec.opts+ file.
+
+  --drb
+
+=== Cucumber
+
+Cucumber has DRb support (see http://wiki.github.com/aslakhellesoy/cucumber/spork-and-drb )
+
+  cucumber --drb
+
+Use this as a guideline when "Sporking" your features/support/env.rb file
+
+  http://gist.github.com/123370
+
+== 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.
+* Lead Media Partners - just for being an awesome place to work.
+
+Spork (c) 2009 Tim Harper, released under the MIT license

data/assets/bootstrap.rb

@@ -0,0 +1,29 @@
+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 through your spec_helper file. Place as much environment loading 
+#   code that you don't normally modify during development in the 
+#   Spork.prefork block.
+# - Place the rest under Spork.each_run block
+# - Any code that is left outside of the blocks will be ran during preforking
+#   and during each_run!
+# - 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/cucumber_rails_integration.feature

@@ -0,0 +1,118 @@
+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'
+
+      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
+        ENV['RAILS_ENV'] = "features"
+        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 'spec/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/cucumber_rails_fr.feature" with:
+      """
+      # language: fr
+      Fonction: French
+        Scénario: ca marche?
+          Alors ca marche
+      """
+    And a file named "features/support/cucumber_rails_helper.rb" with:
+      """
+      $loaded_stuff << 'features/support/cucumber_rails_helper.rb'
+      """
+    And a file named "config/environments/features.rb" with:
+      """
+      # your cucumber env here
+      """
+    And a file named "config/database.yml" with:
+      """
+      features:
+        adapter: sqlite3
+        database: db/features.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 "config/routes.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/features.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/features.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/rails_delayed_loading_workarounds.feature

@@ -0,0 +1,115 @@
+Feature: Rails Delayed Work arounds
+  To allow a rails developer to update as many parts of his application as possible without needing to restart Spork
+  Spork automatically tells rails to delay loading certain parts of the application until after the fork occurs
+  Providing work arounds
+
+  Background: Rails App with RSpec and Spork
+
+    Given I am in a fresh rails project named "test_rails_project"
+    And a file named "spec/spec_helper.rb" with:
+      """
+      require 'rubygems'
+      require 'spork'
+
+      Spork.prefork do
+        require File.dirname(__FILE__) + '/../config/environment.rb'
+        require 'spec'
+        require 'spec/rails'
+      end
+
+      Spork.each_run do
+      end
+      """
+    And the application has a model, observer, route, and application helper
+    Given a file named "app/helpers/application_helper.rb" with:
+      """
+      module ApplicationHelper
+        include Reverseatron
+      end
+      """
+    Given a file named "lib/reverseatron.rb" with:
+      """
+      module Reverseatron
+        def reverse_text(txt)
+          txt.reverse
+        end
+      end
+      """
+    Given a file named "app/controllers/users_controller.rb" with:
+      """
+      class UsersController < ApplicationController
+        $loaded_stuff << 'UsersController'
+        def index
+          @users = []
+        end
+      end
+      """
+    Given a file named "app/helpers/misc_helper.rb" with:
+      """
+      module MiscHelper
+        def misc_helper_method
+          'hello miscellaneous'
+        end
+      end
+      """
+    Given a file named "app/helpers/users_helper.rb" with:
+      """
+      module UsersHelper
+      end
+      """
+    Given a file named "app/views/users/index.html.erb" with:
+      """
+        Original View
+      """
+  Scenario: within a view rendered by a controller, calling helper methods from an included module in ApplicationHelper
+    Given a file named "spec/controllers/users_controller_spec.rb" with:
+      """
+      describe UsersController do
+        integrate_views
+        it "renders a page, using a method inherited from ApplicationController" do
+          get :index
+          response.body.should_not include('Original View')
+          puts "Views are not being cached when rendering from a controller"
+
+          response.body.should include('listing users')
+          puts "Controller stack is functioning when rendering from a controller"
+
+          response.body.should include('hello miscellaneous')
+          puts "All helper modules were included when rendering from a controller"
+        end
+      end
+      """
+    Given a file named "spec/views/index.html.erb_spec.rb" with:
+      """
+      describe "/users/index.html.erb" do
+
+        it "renders the view" do
+          render
+          response.body.should_not include('Original View')
+          puts "Views are not being cached when rendering directly"
+
+          response.body.should include('listing users')
+          puts "Controller stack is functioning when rendering directly"
+
+          response.body.should include('hello miscellaneous')
+          puts "All helper modules were included when rendering directly"
+        end
+      end
+      """
+    When I fire up a spork instance with "spork rspec"
+    And the contents of "app/views/users/index.html.erb" are changed to:
+      """
+      <%= reverse_text('listing users'.reverse) %>
+      <%= misc_helper_method rescue nil %>
+      <p>Here is a list of users</p>
+      """
+      
+    And I run spec --drb spec/controllers/users_controller_spec.rb
+    Then the output should contain "Controller stack is functioning when rendering from a controller"
+    Then the output should contain "Views are not being cached when rendering from a controller"
+    Then the output should contain "All helper modules were included when rendering from a controller"
+
+    And I run spec --drb spec/views/index.html.erb_spec.rb
+    Then the output should contain "Controller stack is functioning when rendering directly"
+    Then the output should contain "Views are not being cached when rendering directly"
+    Then the output should contain "All helper modules were included when rendering directly"

data/features/rspec_rails_integration.feature

@@ -0,0 +1,93 @@
+Feature: Rails Integration
+  To get a developer up and running quickly
+  Spork automatically integrates with rails
+  Providing default hooks and behaviors
+
+  Background: Rails App with RSpec and Spork
+
+    Given I am in a fresh rails project named "test_rails_project"
+    And a file named "spec/spec_helper.rb" with:
+      """
+      require 'rubygems'
+      require 'spork'
+
+      Spork.prefork do
+        # Loading more in this block will cause your specs 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.
+        require File.dirname(__FILE__) + '/../config/environment.rb'
+        require 'spec'
+        require 'spec/rails'
+        
+        #### this is for this test only #######
+        $loaded_stuff << 'prefork block' ######
+        #######################################
+      end
+
+      Spork.each_run do
+        # This code will be run each time you run your specs.
+        
+        #### this is for this test only #######
+        $loaded_stuff << 'each_run block' #####
+        #######################################
+      end
+      """
+    And the application has a model, observer, route, and application helper
+  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 "config/routes.rb"
+  
+  Scenario: Running spork with a rails app and observers
+    Given a file named "spec/did_it_work_spec.rb" with:
+    """
+    describe "Did it work?" do
+      it "checks to see if all worked" do
+        Spork.state.should == :using_spork
+        (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('each_run block')
+        $loaded_stuff.should include('prefork block')
+        puts "Specs successfully run within spork, and all initialization files were loaded"
+      end
+    end
+    """
+    When I fire up a spork instance with "spork rspec"
+    And I run spec --drb spec/did_it_work_spec.rb 
+    Then the error output should be empty
+    And the output should contain "Specs successfully run within spork, and all initialization files were loaded"
+    And the file "log/test.log" should include "hey there"
+
+
+  Scenario: Running spork with a rails app and a non-standard port
+    Given this scenario is pending until rspec releases a version that supports --port
+    Given a file named "spec/did_it_work_spec.rb" with:
+    """
+    describe "Did it work?" do
+      it "checks to see if all worked" do
+        Spork.state.should == :using_spork
+        (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('each_run block')
+        $loaded_stuff.should include('prefork block')
+        puts "Specs successfully run within spork, and all initialization files were loaded"
+      end
+    end
+    """
+    When I fire up a spork instance with "spork rspec --port 7000"
+    And I run spec --drb --port 7000 spec/did_it_work_spec.rb
+    Then the error output should be empty
+    And the output should contain "Specs successfully run within spork, and all initialization files were loaded"
+    And the file "log/test.log" should include "hey there"

data/features/spork_debugger.feature

@@ -0,0 +1,108 @@
+Feature: Spork Debugger integration
+  As a developer
+  I want to invoke the debugger my specs within Spork
+  In order to drill in and figure out what's wrong
+
+  Scenario: Invoking the debugger via 'debugger'
+    Given a file named "spec/spec_helper.rb" with:
+      """
+      require 'rubygems'
+      require 'spork'
+      require 'spork/ext/ruby-debug'
+
+      Spork.prefork { require 'spec' }
+      Spork.each_run { }
+      """
+    And a file named "spec/debugger_spec.rb" with:
+      """
+      require File.dirname(__FILE__) + '/spec_helper.rb'
+
+      describe "Debugger" do
+        it "should debug" do
+          2.times do |count|
+            @message = "count = #{count}"
+            debugger
+            @message = nil
+          end
+          puts "it worked!"
+        end
+      end
+      """
+
+    When I fire up a spork instance with "spork rspec"
+    And I run this in the background: spec --drb spec/debugger_spec.rb
+
+    Then the spork window should output a line containing "Debug Session Started"
+
+    When I type this in the spork window: "e @message"
+    Then the spork window should output a line containing "count = 0"
+
+    When I type this in the spork window: "continue"
+
+    When I type this in the spork window: "e @message"
+    Then the spork window should output a line containing "count = 1"
+
+    When I type this in the spork window: "continue"
+
+    Then the spork window should output a line containing "Debug Session Terminated"
+    And the output should contain "it worked!"
+
+  Scenario: When ruby-debug is already required and started.
+      Given a file named "spec/spec_helper.rb" with:
+      """
+      require 'rubygems'
+      require 'spork'
+      require 'ruby-debug'
+      Debugger.start
+
+      require 'spork/ext/ruby-debug'
+
+      Spork.prefork { require 'spec' }
+      Spork.each_run { }
+      """
+
+    And a file named "spec/debugger_spec.rb" with:
+      """
+      require File.dirname(__FILE__) + '/spec_helper.rb'
+
+      describe "Debugger" do
+        it "should debug" do
+          @message = "yup"
+          debugger
+          puts "it worked!"
+        end
+      end
+      """
+
+    When I fire up a spork instance with "spork rspec"
+    And I run this in the background: spec --drb spec/debugger_spec.rb
+
+    Then the spork window should output a line containing "Debug Session Started"
+
+    When I type this in the spork window: "e @message"
+    Then the spork window should output a line containing "yup"
+
+    When I type this in the spork window: "continue"
+
+    Then the spork window should output a line containing "Debug Session Terminated"
+    And the output should contain "it worked!"
+
+  Scenario: When ruby-debug is invoked during preload
+      Given a file named "spec/spec_helper.rb" with:
+      """
+      require 'rubygems'
+      require 'spork'
+      require 'spork/ext/ruby-debug'
+
+      STDERR.puts("Spork is ready and listening") # trick out the start spork step to believe spork is ready... naughty, but effective.
+      @message = "it worked"
+      debugger
+      Spork.prefork { require 'spec' }
+      Spork.each_run { }
+      """
+
+    When I fire up a spork instance with "spork rspec"
+    Then the spork window should output a line containing "spec_helper.rb"
+    When I type this in the spork window: "e @message"
+    Then the spork window should output a line containing "it worked"
+    When I type this in the spork window: "continue"

data/features/steps/general_steps.rb

@@ -0,0 +1,3 @@
+Given /^this scenario is pending.+/ do
+  pending
+end