rubygems-test - commands and facilities for automated rubygems testing and reporting.

For users

This installs three major features:

.gemrc

You can insert several things in your .gemrc to make things simpler. These all live in the 'test_options' subsection, e.g.:

test_options:
  auto_test_on_install: true 
  test_on_install: true 
  install_development_dependencies: true
  test_development_dependencies: false
  upload_results: false
  force_install: false
  force_uninstall_on_failure: false

All options are false by default. For some of them, if the value is unknown or false, you will be prompted when it is required for testing.

The options:

auto_test_on_install

runs the unit tests when 'gem install' is invoked.

test_on_install

offer to test on install in general. 'auto_test_on_install' overrides this.

install_development_dependencies

automatically install the development dependencies when testing. This is recommended.

test_development_dependencies

recursively test dev dependencies installed by rubygems-test. This can significantly increase the time it takes to install a gem.

upload_results

upload results to gem-testers.org.

upload_service_url

Set to a URL, it will upload to that service instead.

force_install

always install, even on test failures.

force_uninstall_on_failure

force uninstall when tests fail.

For gem developers

Want your gem to be testable?

Note on Patches/Pull Requests

Copyright

Copyright (c) 2010 Erik Hollensbe and Josiah Kiehl. See LICENSE for details.

[Validate]

Generated with the Darkfish Rdoc Generator 2.