A long-lived project that still receives updates
test-unit (Test::Unit) is unit testing framework for Ruby, based on xUnit principles. These were originally designed by Kent Beck, creator of extreme programming software development methodology, for Smalltalk's SUnit. It allows writing tests, checking results and automated testing in Ruby.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0

Runtime

 Project Readme

test-unit

Gem Version Build Status for Ruby 2.1+

Description

An xUnit family unit testing framework for Ruby.

test-unit (Test::Unit) is unit testing framework for Ruby, based on xUnit principles. These were originally designed by Kent Beck, creator of extreme programming software development methodology, for Smalltalk's SUnit. It allows writing tests, checking results and automated testing in Ruby.

test-unit ships as part of Ruby as a bundled gem. To check which version is included, see https://stdgems.org/test-unit/. It's only necessary to install the gem if you need a newer version.

test-unit is the original Ruby unit testing library, and is still active. It is one of two unit testing libraries bundled with Ruby, the other being minitest.

When deciding which to use, consider:

  • test-unit is strict about backwards compatibility. A backwards-incompatible change would be considered a bug.
  • test-unit aims to support old Ruby versions, even if EOL.

Features

  • test-unit 1.2.3 is the original test-unit, taken straight from the ruby distribution. It is being distributed as a gem to allow tool builders to use it as a stand-alone package. (The test framework in ruby is going to radically change very soon).

  • test-unit will be improved actively and may break compatibility with test-unit 1.2.3. (We will not hope it if it isn't needed.)

  • Some features exist as separated gems like GUI test runner. (Tk, GTK+ and Fox) test-unit-full gem package provides for installing all test-unit related gems easily.

How To

  • How To (link for GitHub)
  • {file:doc/text/how-to.md How To} (link for YARD)

Install

% sudo gem install test-unit

If you want to use full test-unit features:

% sudo gem install test-unit-full

License

This software is distributed under either the terms of new Ruby License or BSDL. See the file COPYING.

Exception:

  • lib/test/unit/diff.rb is a triple license of (the new Ruby license or BSDL) and PSF license.

Authors

Active

  • Kouhei Sutou: The current maintainer
  • Haruka Yoshihara: Data driven test supports.

Inactive

  • Nathaniel Talbott: The original author
  • Ryan Davis: The second maintainer

Images

  • Mayu & Co.: kinotan icons

Thanks

  • Daniel Berger: Suggestions and bug reports.
  • Designing Patterns: Suggestions.
  • Erik Hollensbe: Suggestions and bug reports.
  • Bill Lear: A suggestion.
  • Diego Pettenò: A bug report.
  • Angelo Lakra: A bug report.
  • Mike Pomraning: A bug report.
  • David MARCHALAND: Suggestions and bug reports.
  • Andrew Grimm: A bug report.
  • Champak Ch: A bug report.
  • Florian Frank: A bug report.
  • grafi-tt: Bug fixes and reports.
  • Jeremy Stephens: A bug report.
  • Hans de Graaff: Bug reports.
  • James Mead: A bug report.
  • Marc Seeger (Acquia): A bug report.
  • boutil: A bug report.
  • Vladislav Rassokhin: A bug report.