Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

107 lines (66 sloc) 3.99 kb

Guard::Test Build Status

Test::Unit guard allows to automatically & intelligently launch tests when files are modified or created.

If you have any questions about Guard or Guard::Test, please join us on our Google group or on #guard (irc.freenode.net).

Features

  • Compatible with test-unit 2.
  • Tested on Ruby 1.8.7, 1.9.2, REE, Rubinius and JRuby.

Install

Please be sure to have Guard installed before continue.

If you're using Bundler, add it to your Gemfile (inside the development group):

gem 'guard-test'

and run:

$ bundle install

or manually install the gem:

$ gem install guard-test

Add Guard definition to your Guardfile by running this command:

$ guard init test

Usage

Please read the Guard usage doc.

Guardfile

Guard::Test can be adapted to any kind of projects.

See the template Guardfile for some examples.

Please read the Guard documentation for more info about the Guardfile DSL.

Options

Deprecation notice: The :runner option is deprecated. If you had set it to "fastfail", it is now the default in test-unit 2, but if you want the opposite, you can pass the :cli => '--no-show-detail-immediately' option instead.

Available options

  • bundler (Boolean) - Whether or not to use bundle exec to run tests. Default to true if a you have a Gemfile in the current directory.
  • rvm (Array<String>) - Directly run your specs against multiple Rubies. Default to nil.
  • drb (Boolean) - Run your tests with spork-testunit. Default to false.
  • cli (String) - Pass arbitrary CLI arguments to the command that runs the tests. Default to nil.
  • all_on_start (Boolean) - Run all tests on Guard startup. Default to true.
  • all_after_pass (Boolean) - Run all tests after the current run tests pass. Default to true.
  • keep_failed (Boolean) - Re-run failing tests until they pass. Default to true.
  • test_paths (Array<String>) - Array of paths that where are located the test files. Default to ['test'].

drb option

When true, notifications are disabled. This might be fixed in future releases.

test_paths option

By default, guard-test will only look for test files within test/ in your project root. You can add any paths using the :test_paths option:

guard :test, :test_paths => ['test', 'vendor/plugins/recaptcha/test', 'any/path/test'] do
  # ...
end

Development

Pull requests are very welcome! Please try to follow these simple "rules", though:

  • Please create a topic branch for every separate change you make;
  • Make sure your patches are well tested;
  • Update the README (if applicable);
  • Update the CHANGELOG and add yourself to the list of contributors (see at the bottom of the CHANGELOG for examples);
  • Please do not change the version number.

For questions please join us on our Google group or on #guard (irc.freenode.net).

Author

Rémy Coutable

Contributors

https://github.com/guard/guard-test/contributors

Kudos

Many thanks to Thibaud Guillaume-Gentil for creating the excellent Guard gem.

Jump to Line
Something went wrong with that request. Please try again.