pietervisser-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,11 @@
+= Spork
+
+This is a fork of http://github.com/timcharper/spork
+For more information, please look at his repository.
+
+to install this fork as a gem:
+  [sudo] gem install pietervisser-spork
+
+== Changes
+
+* Spork.each_run was not run in windows, because of a bug in the expanded_caller def. The line was split by ':', but in windows the drive letter also contains a ':' like 'c:/...'. 

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

data/features/steps/rails_steps.rb

@@ -0,0 +1,53 @@
+Given /^I am in a fresh rails project named "(.+)"$/ do |folder_name|
+  @current_dir = SporkWorld::SANDBOX_DIR
+  version_argument = ENV['RAILS_VERSION'] ? "_#{ENV['RAILS_VERSION']}_" : nil
+  # run("#{SporkWorld::RUBY_BINARY} #{%x{which rails}.chomp} #{folder_name}")
+  run([SporkWorld::RUBY_BINARY, '-I', Cucumber::LIBDIR, %x{which rails}.chomp, version_argument, folder_name].compact * " ")
+  @current_dir = File.join(File.join(SporkWorld::SANDBOX_DIR, folder_name))
+end
+
+
+Given "the application has a model, observer, route, and application helper" do
+  Given 'a file named "app/models/user.rb" with:',
+    """
+    class User < ActiveRecord::Base
+      $loaded_stuff << 'User'
+    end
+    """
+  Given 'a file named "app/models/user_observer.rb" with:',
+    """
+    class UserObserver < ActiveRecord::Observer
+      $loaded_stuff << 'UserObserver'
+    end
+    """
+  Given 'a file named "app/helpers/application_helper.rb" with:',
+    """
+    module ApplicationHelper
+      $loaded_stuff << 'ApplicationHelper'
+    end
+    """
+  Given 'the following code appears in "config/environment.rb" after /Rails::Initializer.run/:',
+    """
+      config.active_record.observers = :user_observer
+    """
+  Given 'the following code appears in "config/routes.rb" after /^end/:',
+    """
+      $loaded_stuff << 'config/routes.rb'
+    """
+  Given 'a file named "config/initializers/initialize_loaded_stuff.rb" with:',
+    """
+    $loaded_stuff ||= []
+    """
+  Given 'a file named "config/initializers/log_establish_connection_calls.rb" with:',
+    """
+    class ActiveRecord::Base
+      class << self
+        def establish_connection_with_load_logging(*args)
+          establish_connection_without_load_logging(*args)
+          $loaded_stuff << 'ActiveRecord::Base.establish_connection'
+        end
+        alias_method_chain :establish_connection, :load_logging
+      end
+    end
+    """
+end