test_startup 0.1.0

data/README.markdown

@@ -0,0 +1,33 @@
+Test Startup
+============
+
+Adds test-case wide startup and shutdown hooks to test/unit (or shoulda). Here's an example:
+    
+    require "test_startup"
+
+    class MyTest < Test::Unit::TestCase
+    
+      startup do
+        start_some_server
+      end
+      
+      def test_should_access_server_properly
+        # whatever
+      end
+      
+      def test_should_do_other_servery_things
+        # also, whatever
+      end
+      
+      shutdown do
+        stop_the_server
+      end
+      
+    end
+
+This avoids the overhead of starting the server for each and every test case.
+
+
+Caveats
+-------
+You should probably think long and hard about whether or not you need this. In general, it's a good idea to have each test operate independently of each other, and this technique is only useful when it takes so long to setup the server (for example) that performing that for every test is not practical.

data/lib/test_startup.rb

@@ -0,0 +1,41 @@
+require 'test/unit'
+
+module TestStartupAndShutdown
+  def startup(&block)
+    install_global_startup
+    @__startup_blocks ||= []
+    @__startup_blocks << block if block_given?
+    @__startup_blocks
+  end
+  
+  def shutdown(&block)
+    install_global_startup
+    @__shutdown_blocks ||= []
+    @__shutdown_blocks << block if block_given?
+    @__shutdown_blocks
+  end
+  
+  attr_reader :__startup_blocks, :__shutdown_blocks
+  
+  def install_global_startup
+    extend(TestSuiteWithGlobalStartup)
+  end
+  
+  module TestSuiteWithGlobalStartup
+    def suite(*args)
+      mysuite = super
+      these_startup_blocks = __startup_blocks
+      these_shutdown_blocks = __shutdown_blocks
+      mysuite.instance_eval { @__startup_blocks = these_startup_blocks }
+      mysuite.instance_eval { @__shutdown_blocks = these_shutdown_blocks }
+      def mysuite.run(*args)
+        @__startup_blocks.each { |block| block.call }
+        super
+        @__shutdown_blocks.each { |block| block.call }
+      end
+      mysuite
+    end
+  end
+end
+
+Test::Unit::TestCase.extend(TestStartupAndShutdown)

data/test/test_startup_test.rb

@@ -0,0 +1,49 @@
+$:.push File.join(File.dirname(__FILE__), *%w[.. lib])
+
+require 'test/unit'
+require 'test/unit/ui/console/testrunner'
+require 'test_startup'
+
+class TestArtefact
+  class << self
+    attr_accessor :started, :stopped
+  end
+  
+  self.started = 0
+  self.stopped = 0
+end
+
+class TestStartupTest < Test::Unit::TestCase
+  startup { TestArtefact.started += 1 }
+  shutdown { TestArtefact.stopped += 1 }
+  
+  def test_should_call_startup_callback
+    assert_equal 1, TestArtefact.started
+  end
+  
+  def test_should_only_call_startup_callback_once
+    assert_equal 1, TestArtefact.started
+  end
+  
+  def test_should_not_call_stopped_while_tests_are_running
+    assert_equal 0, TestArtefact.stopped
+  end
+end
+
+class TestStartupExternalTest < Test::Unit::TestCase
+  def test_should_call_shutdown_when_test_case_tests_have_finished
+    assert_equal 1, TestArtefact.stopped
+  end
+end
+
+class TestStartupSuite < Test::Unit::TestSuite
+  # taking advantage of the fact that the tests run in the order they're added here.
+  def self.suite
+    result = self.new(self.class.name)
+    result << TestStartupTest.suite
+    result << TestStartupExternalTest.suite
+    return result
+  end
+end
+
+Test::Unit::UI::Console::TestRunner.run(TestStartupSuite)

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification 
+name: test_startup
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- James Adam
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-07-23 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: 
+email: james@lazyatom.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.markdown
+files: 
+- README.markdown
+- test/test_startup_test.rb
+- lib/test_startup.rb
+has_rdoc: true
+homepage: http://lazyatom.com
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.markdown
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: test_startup
+rubygems_version: 1.3.3
+signing_key: 
+specification_version: 3
+summary: Adds Ruby 1.9-style startup and shutdown mechanisms to test/unit (or shoulda)
+test_files: []
+