This is the testiere Reference Manual, version 1.5.1, generated automatically by Declt version 4.0 beta 2 "William Riker" on Fri May 15 13:07:01 2026 GMT+0.
The main system appears first, followed by any subsystem dependency.
testiereTDD system for Common Lisp
Colin <colin@cicadas.surf>
GPLv3
1.5.1
package.lisp (file).
testiere.lisp (file).
standard-hooks.lisp (file).
Files are sorted by type and then listed depth-first from the systems components trees.
testiere/testiere.lisppackage.lisp (file).
testiere (system).
off (function).
on (function).
register-hook (function).
run-suites (function).
*cached-macroexpand-hook* (special variable).
*run-tests* (special variable).
*suite-dict* (special variable).
*testiere-hooks* (special variable).
add-test-to-package-suite (function).
copy-testiere-hook (function).
expand-defun-stubs (function).
expand-generic-stub (function).
expand-test-form (function).
expand-test-forms (function).
failed (function).
make-testiere-hook (function).
report (function).
report-and-continue-tests (function).
run-package-suite (function).
run-test (function).
test-failure-error (condition).
testiere-error (condition).
testiere-hook (function).
testiere-hook (structure).
testiere-hook-extractor (reader).
(setf testiere-hook-extractor) (writer).
testiere-hook-form-key-fn (reader).
(setf testiere-hook-form-key-fn) (writer).
testiere-hook-p (function).
testiere-hook-restarts-expander (reader).
(setf testiere-hook-restarts-expander) (writer).
testiere/standard-hooks.lisptestiere.lisp (file).
testiere (system).
defclass-restarts-expander (function).
defun-restarts-expander (function).
standard-extractor (function).
standard-form-key (function).
Packages are listed by definition order.
testierecommon-lisp.
off (function).
on (function).
register-hook (function).
run-suites (function).
*cached-macroexpand-hook* (special variable).
*run-tests* (special variable).
*suite-dict* (special variable).
*testiere-hooks* (special variable).
add-test-to-package-suite (function).
copy-testiere-hook (function).
defclass-restarts-expander (function).
defun-restarts-expander (function).
expand-defun-stubs (function).
expand-generic-stub (function).
expand-test-form (function).
expand-test-forms (function).
failed (function).
make-testiere-hook (function).
report (function).
report-and-continue-tests (function).
run-package-suite (function).
run-test (function).
standard-extractor (function).
standard-form-key (function).
test-failure-error (condition).
testiere-error (condition).
testiere-hook (function).
testiere-hook (structure).
testiere-hook-extractor (reader).
(setf testiere-hook-extractor) (writer).
testiere-hook-form-key-fn (reader).
(setf testiere-hook-form-key-fn) (writer).
testiere-hook-p (function).
testiere-hook-restarts-expander (reader).
(setf testiere-hook-restarts-expander) (writer).
Definitions are sorted by export status, category, package, and then by lexicographic order.
Turn testiere on by pushing :testiere into cl:*features*.
If RUN-TESTS is NIL, then compiling forms with embedded tests WILL
NOT run the embedded tests but will still add them to the test
suites. This is useful for running test suites in scripted
situations.
Testiere can be turned on again to change the RUN-TESTS state.
Register a new hook for use with testiere.
MACRO is a symbol naming a macro-function
EXTRACTOR is a function of one argument, FORM representing the &WHOLE
of the macro-function call. It returns two values: a modified s form
identical with FORM except (:tests ...) forms have been
removed. The second value should be the conatenation of the CDRs of
these (:tests ...) forms.
RESTARTS-EXPANDER is an optional functionof one argument. It returns the restart handler clauses of a RESTART-CASE form. These are the restarts to try when tests fail.
PACKAGES is a list of pacakge designators. Attempts to run test
suites named in PACKAGES. If PACKAGES is NIL, then all known test
suites are run.
If AUTOMATIC-CONTINUE is T then all TEST-FAILURE-ERRORs will be handled by printing a test failure before continuing with the suite.
If REQUIRE-ALL is T then an error will be signalled if no suite exists for one of the members of PACKAGES.
When T, run tests on compile. Disable this to build a test suite without running the tests on compile.
PACKAGE -> {FORM-KEY -> TEST-LAMBDA}
Registry of macro functions and testiere-hook
Signal a TEST-FAILURE-ERROR. TEST is a deignator for the
test. REASON-FMT is a format string and FMT-ARGS are arguments to that
string, to be processed by CL:FORMAT.
A somewhat naive default test form extractor. Returns two values, orig-form without test forms included, and a collection of test forms.
The first is a list (MACRO NAME) that uniquely identifies the form
form which tests are being defined. NAME’s package is the suite to
which the tests of FORM will be be added.
This form key function is sutable for Common Lisp definition macros.
:test
error.
:reason
| Jump to: | (
A C D E F M O R S T |
|---|
| Jump to: | (
A C D E F M O R S T |
|---|
| Jump to: | *
E F R S T |
|---|
| Jump to: | *
E F R S T |
|---|
| Jump to: | C F P S T |
|---|
| Jump to: | C F P S T |
|---|