ArTestRunner

Run the ActiveRecord test suite with your gem/module/plugin loaded. Choose the ActiveRecord version and database.

Install

Install as either a gem or a plugin.

Gem

  gem sources -a http://gems.github.com
  sudo gem install blythedunham-ar_test_runner

Plugin

  script/plugin install git://github.com/blythedunham/ar_test_runner

Run

Run either of these from the RAILS_ROOT of your application

ar_test_runner

Run all plugins and lib files against sqlite for app version

  ar_test_runner DB=sqlite

Test 2.3.2 with rails_devs_for_data_integrity plugin loaded on mysql (default)

  ar_test_runner PLUGIN=rails_devs_for_data_integrity AR_DIR=/Library/Ruby/Gems/1.8/gems/activerecord-2.3.2

If installed as a gem, the executable is copied to your bin. With a plugin, you should invoke the file directly

  vendor/plugins/ar_test_runner/bin/ar_test_runner

Rake task

Run all plugins and lib files against sqlite for app version

  rake test:activerecord:sqlite

Test 2.3.2 with rails_devs_for_data_integrity plugin loaded on mysql

  rake test:activerecord:mysql PLUGIN=rails_devs_for_data_integrity AR_DIR=/Library/Ruby/Gems/1.8/gems/activerecord-2.3.2

With a plugin, rake tasks will automatically appear. If installed as a gem, please require ‘ar_test_runner’ in the Rakefile

  require 'ar_test_runner'

Parameters

• AR_DIR - ActiveRecord directory. Works with frozen rails directories and gem locations. Defaults to the apps version of ActiveRecord
• PLUGIN - specify a plugin to use
• FILE - files to load separated with commas. Create a file that requires everything you need loaded for super detailed configurations. Relative and full paths are fine.
• REQUIRE - like FILE but does not expand the path. Use for gems and requiring file that are not relative to RAILS_ROOT</tt>.
• SKIP - list of directories or file names separated by commas to exclude.
• DRY_RUN - prints out list of files to loaded but does not run the tests
• AR_RUN_DEFAULT - set to true to include all files in the lib directory and plugins. These are run when REQUIRE,FILE, and PLUGIN is not specified
• DB - specify the db name (ex: sqlite or mysql) with DB when using this with ar_test_runner ruby script. The database is specified in the task when run as a rake task. Example: rake test:activerecord:mysql

If REQUIRE,FILE, and PLUGIN are not specified, or AR_RUN_DEFAULT is set, all plugins(vendor/plugins/**/init.rb) and lib files(lib/*.rb) are loaded. Use SKIP to exclude directories. Plugins referencing ActionController are automatically disabled.

Examples

Run default Run (plugins and libs) on postgre

  rake activerecord:test:postgresql

Skip Load everything in lib and all of the plugins but skip smsonrails using a frozen version of 2.2.2

  rake test:activerecord:sqlite3 AR_DIR=/Users/blythedunham/projects/arversions/AR2.2.2/vendor/rails/activerecord SKIP=smsonrails

Custom File If there are a lot of files to load, or for super custom requires, create a file and require everything there. Will use which ever version of ActiveRecord your app uses (loaded in config/boot.rb)

ar_requires.rb might look like:

  require File.dirname(__FILE__) + '../../models/awesome.rb'
  require 'supergemthing'

Then run it:

  rake activerecord:test:mysql FILES=config/ar_regression_requires.rb

Developers

• Blythe Dunham snowgiraffe.com

Homepage

• Project Site: github.com/blythedunham/ar_test_runner

Copyright © 2009 Blythe Dunham, released under the MIT license