with-tests

Arguments: (&key (name "unnamed")) &body body

The body should be test forms. At the end of execution of the body, a report is generated which summarizes successes and failures.

with-tests binds *test-successes*, *test-errors*, and *test-unexpected-failures* to 0 before the execution of body and the printing of the results.

name is printed with the results -- "Begin <name> test", so "Begin unnamed test" if unspecified.

Multip[rocessing note: when tests run in multiple threads, the counters bound by an occurrence of the with-tests macro accumulate counts only from tests running in the same thread. If code within the scope of a with-tests macro starts another thread where tests may also run, the latter tests will increment the global counters (or some other with-tests scope).

See test-harness.htm for information on the Allegro CL test harness.

Copyright (c) 1998-2019, Franz Inc. Oakland, CA., USA. All rights reserved.
This page has had moderate revisions compared to the 8.2 page.
Created 2019.8.20.