lisp-unit

https://github.com/OdonataResearchLLC/lisp-unit.git

git clone 'https://github.com/OdonataResearchLLC/lisp-unit.git'

(ql:quickload :lisp-unit)

---

lisp-unit

lisp-unit is a Common Lisp library that supports unit testing. It is an extension of the library written by Chris Riesbeck. There is a long history of testing packages in Lisp, usually called “regression” testers. More recent packages in Lisp and other languages have been inspired by JUnit for Java.

Documentation is located on the project wiki.

Features

• Written in portable Common Lisp
• Loadable as a single file
• Loadable with ASDF or Quicklisp
• Simple to define and run tests
• Redfine functions and macros without reloading tests
• Test return values, printed output, macro expansions, and conditions
• Fined grained control over the testing output
• Store all test results in a database object that can be examined
• Group tests by package for modularity
• Group tests using tags
• Signal test completion and return results with the condition.

Extensions

• Floating point predicates
• Test Anything Protocol output

How to use lisp-unit

The core definitions of lisp-unit may be used by loading the single file ‘lisp-unit.lisp’. To use the extensions, lisp-unit must be loaded using either Quicklisp or ASDF.

1. Load (or compile and load) as a single file : (load "lisp-unit").
2. Load using Quicklisp : (ql:quickload :lisp-unit).
3. Load using ASDF : (asdf:load-system :lisp-unit).

Version 0.9.5 Features

No new features, improved the usability based on user feedback. The list of tests or tags to the following functions is now optional and defaults to :ALL.

• (remove-tests [names] [package])
• (tagged-tests [tags] [package])
• (remove-tags [tags] [package])
• (run-tests [names] [package])
• (run-tags [tags] [package])

Version 1 Remaining Tasks

• (1.0.0) Expanded internal testing.

Future Features

• Fixtures
• Test Suites
• Benchmarking tools

0.9.5 Acknowledgments

• Jesse Alama for usability feedback.