kookaburra 0.17.0 → 0.17.1

data/README.markdown

@@ -39,11 +39,35 @@ to tell Kookaburra which classes contain the specific Domain Driver
 implementations for your application as well as which driver to use for running
 the tests (currently only tested with [Capybara] [Capybara]).
 
+### ActiveRecord and Database Transactions ###
+
+Kookaburra currently uses Rack::Test as the underlying implementation for its
+APIDriver classes. This poses a problem when you want to run your UI tests via a
+driver other than Rack::Test such as Selenium, because the APIDriver sets up
+your test data using a different database connection than the process that runs
+the server against which Selenium executes, and they do not have access to the
+same transaction.
+
+One way to handle this problem is to force ActiveRecord to use the same
+connection in both the main thread and the thread that is spun up by Capybara to
+run the application for Selenium testing. You can do so by requiring
+`kookaburra/utils/active_record_shared_connection` within your Kookaburra setup.
+
+In the near future, we plan to change Kookaburra to execute *both* its APIDriver
+and UIDriver against an actual server and ditch Rack::Test. Not only will this
+help avoid this specific problem, but it will move towards the goal of being
+able to (optionally) run these tests on a completely different machine than the
+running application.
+
 ### RSpec ###
 
 For [RSpec] [RSpec] integration tests, just add the following to
 `spec/support/kookaburra_setup.rb`:
 
+    # only if using ActiveRecord and a browser driver other than Rack::Test for
+    # UI testing
+    require 'kookaburra/utils/active_record_shared_connection'
+
     require 'kookaburra/test_helpers'
     require 'my_app/kookaburra/api_driver'
     require 'my_app/kookaburra/given_driver'
@@ -67,6 +91,10 @@ For [RSpec] [RSpec] integration tests, just add the following to
 
 For [Cucumber] [Cucumber], add the following to `features/support/kookaburra_setup.rb`:
 
+    # only if using ActiveRecord and a browser driver other than Rack::Test for
+    # UI testing
+    require 'kookaburra/utils/active_record_shared_connection'
+
     require 'kookaburra/test_helpers'
     require 'my_app/kookaburra/api_driver'
     require 'my_app/kookaburra/given_driver'

data/VERSION

@@ -1 +1 @@
-0.17.0
+0.17.1

data/kookaburra.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "kookaburra"
-  s.version = "0.17.0"
+  s.version = "0.17.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["John Wilger", "Sam Livingston-Gray", "Ravi Gadad"]
-  s.date = "2012-03-16"
+  s.date = "2012-03-17"
   s.description = "Cucumber + Capybara = Kookaburra? It made sense at the time."
   s.email = "johnwilger@gmail.com"
   s.extra_rdoc_files = [
@@ -39,6 +39,7 @@ Gem::Specification.new do |s|
     "lib/kookaburra/test_helpers.rb",
     "lib/kookaburra/ui_driver.rb",
     "lib/kookaburra/ui_driver/ui_component.rb",
+    "lib/kookaburra/utils/active_record_shared_connection.rb",
     "spec/kookaburra/json_api_driver_spec.rb",
     "spec/kookaburra/rack_driver_spec.rb",
     "spec/kookaburra/test_data_spec.rb",

data/lib/kookaburra/utils/active_record_shared_connection.rb

@@ -0,0 +1,14 @@
+require 'active_record'
+
+class ActiveRecord::Base
+  mattr_accessor :shared_connection
+  @@shared_connection = nil
+
+  def self.connection
+    @@shared_connection || retrieve_connection
+  end
+end
+
+# Forces all threads to share the same connection. This works on
+# Capybara because it starts the web server in a thread.
+ActiveRecord::Base.shared_connection = ActiveRecord::Base.connection

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: kookaburra
 version: !ruby/object:Gem::Version 
-  hash: 91
+  hash: 89
   prerelease: 
   segments: 
   - 0
   - 17
-  - 0
-  version: 0.17.0
+  - 1
+  version: 0.17.1
 platform: ruby
 authors: 
 - John Wilger
@@ -17,7 +17,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-03-16 00:00:00 Z
+date: 2012-03-17 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   version_requirements: &id001 !ruby/object:Gem::Requirement 
@@ -207,6 +207,7 @@ files:
 - lib/kookaburra/test_helpers.rb
 - lib/kookaburra/ui_driver.rb
 - lib/kookaburra/ui_driver/ui_component.rb
+- lib/kookaburra/utils/active_record_shared_connection.rb
 - spec/kookaburra/json_api_driver_spec.rb
 - spec/kookaburra/rack_driver_spec.rb
 - spec/kookaburra/test_data_spec.rb