Using autotest with Rails (with ZenTest prior to 3.5.0)Edit

Created 5/24/2007, updated 5/18/2017

These are an older version of the notes at "Using autotest with Rails". These were written for use in conjunction with versions of ZenTest prior to version 3.5.0.

Prerequisites

ZenTest (see "Setting up autotest")
diff-lcs (already installed in my case)
RSpec (again, already installed in my case)

Installing the RSpec Rails plugin

You have to use the version of the plug-in corresponding with your installed version of RSpec so in my case at the time of writing this corresponds to the REL_0_9_0_BETA_1 tag (see "Trying out the rspec version 0.9 preview"). From the top of the application directory:

script/plugin install svn://rubyforge.org/var/svn/rspec/tags/REL_0_9_0_BETA_1/rspec_on_rails

After installing you must "bootstrap" RSpec as follows:

script/generate rspec

Output:

      create  spec
      create  spec/spec_helper.rb
      create  spec/spec.opts
      create  previous_spec_failures.txt
      create  script/spec_server
      create  script/spec

For more information see http://rspec.rubyforge.org/documentation/rails/install.html

I later installed RSpec itself as a plug-in alongside of rspec_on_rails:

script/plugin install svn://rubyforge.org/var/svn/rspec/tags/REL_0_9_0_BETA_2/rspec
script/plugin install --force svn://rubyforge.org/var/svn/rspec/tags/REL_0_9_0_BETA_2/rspec_on_rails

This was necessary in order to get autotest from the new version of ZenTest (3.5.0 at the time of writing) working. Note that I took the opportunity to upgrade to the latest beta. I had to supply the --force switch in order to force the upgrade to overwrite the existing copy of the plug-in.

Installing `rspec_autotest`

script/plugin install http://svn.caldersphere.net/svn/main/plugins/rspec_autotest

Exactly how to uninstall a previously-installed copy of the plugin depends on how you installed it and whether it is under source control or not. In my case, it was stored in my SVK repository and so I uninstalled as follows:

# from top-level of the application in a checked out working copy:
cd vendor/plugins
svk rm rspec_autotest

Starting autotest

rake spec:autotest

Tweaks

I was seeing a lot of warnings, invalid option: -s (OptionParser::InvalidOption), due to the fact that the plug-in is passing a switch that RSpec no longer supports in 0.9.0 beta 1 (and in fact I can’t find any information on what it used to do); I assume it was for specifying an individual specification. I was able to silence these by changing the -s to an -e because specifications are now called examples in RSpec 0.9:

methods.each { |meth| cmds << "#{spec_command} -s #{meth.inspect} #{klass}" }

To:

methods.each { |meth| cmds << "#{spec_command} -e #{meth.inspect} #{klass}" }

At line 91 of rspec_autotest.rb.

Here’s a ticket for the issue with a basic patch: http://trac.caldersphere.net/projects/main/ticket/125

Additional Rails configuration

David Chelimsky points out in this rspec-users mailing list post that you should remove the following lines from the spec/spec.opts file:

--format
failing_examples:previous_failures.txt
--example
previous_failures.txt

This prevents the tests from failing continuously when an example fails; autotest will run the specs again automatically once changes have been made.