transactional-factories 0.1.1

data/README.rdoc

@@ -0,0 +1,41 @@
+= Transactional-factories
+
+transactional-factories uses nested-transactions to allow efficient, programmatic initialization of test data.
+
+Typical setup/teardown TestCase callbacks are called prior to every test method.  Ruby's Test::Unit::TestCase wraps each test method in a transaction.  If your test data must be created programmatically, the data creation code must be run prior to every test method.  When the data creation code is slow, this will greatly increase the time it takes to run tests.  
+
+transactional-factories provides self.setup and self.teardown callbacks that are run only once for the entire testsuite.  A file-level transaction is used to unwind any changes made in self.setup.  Then any test methods are called in nested transactions (per normal TestCase behavior).  This relies on database transactions so that we only have to run our data creation code once.
+
+  require 'transactional_factories'
+
+  class MyTest < Test::Unit::TestCase
+    def self.setup
+      100.times { MyModel.create }
+    end
+    
+    def test_my_model_1
+      assert_equal 100, MyModel.create
+      MyModel.create
+      assert_equal 101, MyModel.create
+    end
+    
+    def test_my_model_2
+      assert_equal 100, MyModel.create
+      MyModel.create
+      assert_equal 101, MyModel.create
+    end
+  end
+
+=== Dependencies
+
+<b>nested transactional db</b> - You must be using a database that supports nested transactions or savepoints.  I've only tested on MySQL.  Would be nice to have someone confirm this on PostgreSQL.
+
+<b>>= ActiveRecord 2.3.x</b> - I don't think ActiveRecord supported nested transactions until 2.3.x.
+
+<b>use_transactional_fixtures = false</b> - Your test cases can not use transactional fixtures.  They're doing about the same thing that the transactional-factories gem is doing and they stomp on each other. 
+
+If you get this: TransactionalFactories::TransactionalFixturesEnabled, it's time to disable transactional fixtures doing something like this:
+
+  class ActiveSupport::TestCase
+    self.use_transactional_fixtures = false
+  end

data/Rakefile

@@ -0,0 +1,30 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "transactional-factories"
+    gem.summary = "Using nested-transactions to initialize test data programmatically."
+		gem.description = "Transactional-factories uses nested-transactions (like transactional fixtures) to allow efficient initialization of test data programmatically (unlike transactional fixtures)."
+    gem.email = "tim.harrison@yahoo.com"
+    gem.homepage = "http://github.com/heedspin/transactional-factories"
+    gem.authors = ["Tim Harrison"]
+    gem.add_dependency('activerecord', '>= 2.3.2')
+    gem.files.exclude '.gitignore'
+  end
+  Jeweler::RubyforgeTasks.new
+rescue LoadError
+  puts "Jeweler gem is missing"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+task :test => :check_dependencies
+
+task :default => :test

data/VERSION

@@ -0,0 +1 @@
+0.1.1

data/lib/transactional_factories.rb

@@ -0,0 +1,2 @@
+require 'transactional_factories/test_suite'
+require 'transactional_factories/test_case'

data/lib/transactional_factories/test_case.rb

@@ -0,0 +1,21 @@
+class Test::Unit::TestCase
+  class << self
+    def suite
+      method_names = public_instance_methods(true)
+      tests = method_names.delete_if {|method_name| method_name !~ /^test./}
+      suite = TransactionalFactories::TestSuite.new(name)
+      tests.sort.each do
+        |test|
+        catch(:invalid_test) do
+          suite << new(test)
+        end
+      end
+      if (suite.empty?)
+        catch(:invalid_test) do
+          suite << new("default_test")
+        end
+      end
+      return suite
+    end
+  end
+end

data/lib/transactional_factories/test_suite.rb

@@ -0,0 +1,36 @@
+require 'test/unit'
+
+module TransactionalFactories
+  class TransactionalFixturesEnabled < Exception
+  end
+  class TestSuite < Test::Unit::TestSuite
+    def run(result, &progress_block)
+      if testcase = @tests.find { |tc| tc.class.respond_to?(:setup) }
+        if testcase.class.respond_to?(:use_transactional_fixtures) and testcase.class.use_transactional_fixtures
+          raise TransactionalFixturesEnabled, 'transactional-factories does not work with transactional fixtures.  Please set use_transactional_fixtures = false.'
+        end
+      end
+      if @tests.any? { |testcase| testcase.method_name != 'default_test' }
+        ActiveRecord::Base.transaction(:requires_new => true) do
+          testcase.class.setup if testcase
+          begin
+            yield(STARTED, name)
+            @tests.each do |test|
+              ActiveRecord::Base.transaction(:requires_new => true) do
+                test.run(result, &progress_block)
+                raise ActiveRecord::Rollback
+              end
+            end
+            yield(FINISHED, name)
+          rescue
+            raise $!
+          ensure
+            testcase.class.teardown if testcase.class.respond_to?(:teardown)
+          end
+          Timecop.return if defined?(Timecop)
+          raise ActiveRecord::Rollback
+        end
+      end
+    end
+  end
+end

data/test/db/schema.rb

@@ -0,0 +1,5 @@
+ActiveRecord::Schema.define do
+  create_table "blog_posts", :force => true do |t|
+    t.column "title", :string
+  end
+end

data/test/lib/blog_post.rb

@@ -0,0 +1,2 @@
+class BlogPost < ActiveRecord::Base
+end

data/test/test_helper.rb

@@ -0,0 +1,15 @@
+require 'test/unit'
+require 'rubygems'
+require 'active_record'
+
+ActiveRecord::Base.logger = Logger.new(STDOUT)
+ActiveRecord::Base.colorize_logging = false
+
+ActiveRecord::Base.establish_connection( { :adapter => 'mysql', :database => 'test' } )
+ActiveRecord::Base.connection.recreate_database('transactional_factories_test')
+ActiveRecord::Base.clear_active_connections!
+ActiveRecord::Base.establish_connection( { :adapter => 'mysql', :database => 'transactional_factories_test' } )
+
+load File.dirname(__FILE__) + '/db/schema.rb'
+$:.push File.dirname(__FILE__) + '/lib'
+$:.push File.dirname(__FILE__) + '/../lib'

data/test/unit/blog_post_test.rb

@@ -0,0 +1,35 @@
+require File.dirname(__FILE__) + '/../test_helper'
+
+require 'blog_post'
+require 'transactional_factories'
+
+class TestBlogPost < Test::Unit::TestCase
+  @@initial_blog_post = nil
+  def self.setup
+    @@initial_blog_post = BlogPost.create(:title => 'initial blog post')
+  end
+
+  def self.teardown
+    raise 'Teardown unhappy' if @@initial_blog_post.nil?
+    # Hard to assert on teardown since it's the last step.  How would you know it *didn't* happen?
+  end
+  
+  def setup
+    assert @@initial_blog_post
+    assert_equal @@initial_blog_post, BlogPost.first
+    BlogPost.create(:title => 'setup blog post')
+  end
+  
+  def test_blog_post1
+    assert_equal 2, BlogPost.count
+    BlogPost.create(:title => 'blog post 1')
+    assert_equal 3, BlogPost.count
+  end
+  
+  def test_blog_post2
+    assert_equal 2, BlogPost.count
+    BlogPost.create(:title => 'blog post 2')
+    assert_equal 3, BlogPost.count
+  end
+  
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: transactional-factories
+version: !ruby/object:Gem::Version 
+  version: 0.1.1
+platform: ruby
+authors: 
+- Tim Harrison
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-31 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activerecord
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.3.2
+    version: 
+description: Transactional-factories uses nested-transactions (like transactional fixtures) to allow efficient initialization of test data programmatically (unlike transactional fixtures).
+email: tim.harrison@yahoo.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/transactional_factories.rb
+- lib/transactional_factories/test_case.rb
+- lib/transactional_factories/test_suite.rb
+- test/db/schema.rb
+- test/lib/blog_post.rb
+- test/test_helper.rb
+- test/unit/blog_post_test.rb
+has_rdoc: true
+homepage: http://github.com/heedspin/transactional-factories
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+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: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Using nested-transactions to initialize test data programmatically.
+test_files: 
+- test/db/schema.rb
+- test/lib/blog_post.rb
+- test/test_helper.rb
+- test/unit/blog_post_test.rb