https://github.com/test-unit/test-unit
test-unit
https://github.com/test-unit/test-unit
Last synced: 23 days ago
JSON representation
test-unit
- Host: GitHub
- URL: https://github.com/test-unit/test-unit
- Owner: test-unit
- License: other
- Created: 2011-04-10T15:53:10.000Z (about 14 years ago)
- Default Branch: master
- Last Pushed: 2025-03-20T00:38:41.000Z (28 days ago)
- Last Synced: 2025-03-20T21:08:58.754Z (27 days ago)
- Language: Ruby
- Homepage: http://test-unit.github.io/
- Size: 3.4 MB
- Stars: 266
- Watchers: 26
- Forks: 103
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
- awesome-ruby-toolbox - test-unit - 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. (Testing / Unit Test Frameworks)
README
# test-unit
[](http://badge.fury.io/rb/test-unit)
[](https://github.com/test-unit/test-unit/actions/workflows/test.yml?query=branch%3Amaster+)
* http://test-unit.github.io/
* https://github.com/test-unit/test-unit
## 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](https://github.com/minitest/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](https://github.com/test-unit/test-unit/blob/master/doc/text/how-to.md) (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](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.