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-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.