Common Lisp Package: CLERIC-TEST

README:

CLERIC - Common Lisp Erlang Interface

CLERIC is an implementation of the Erlang distribution protocol, comparable with erl_interface and jinterface.

Homepage: <http://common-lisp.net/project/cleric/>

Please see the doc/ directory for further documentation. The latest documentation is available online.

How to install

CLERIC is easily installed with Quicklisp or ASDF-Install.

Using Quicklisp:

> (ql:quickload :cleric) 

Using ASDF-Install:

> (asdf-install:install :cleric) 

One can also download a tarball and untar it where ASDF can find it.

To check out the latest code, use git:

$ git clone git://github.com/flambard/CLERIC.git  

Dependencies

Quicklisp and ASDF-Install will download and install these libraries automatically when installing CLERIC.

FUNCTION

Public

Undocumented

RUN-ALL-TESTS

Private

RUN! (&OPTIONAL (TEST-SPEC *SUITE*))

Equivalent to (explain (run TEST-SPEC)).

MACRO

Private

DEF-SUITE (NAME &KEY DESCRIPTION IN)

Define a new test-suite named NAME. IN (a symbol), if provided, causes this suite te be nested in the suite named by IN. NB: This macro is built on top of make-suite, as such it, like make-suite, will overrwrite any existing suite named NAME.

IN-SUITE (SUITE-NAME)

Set the *suite* special variable so that all tests defined after the execution of this form are, unless specified otherwise, in the test-suite named SUITE-NAME. See also: DEF-SUITE *SUITE*

IS (TEST &REST REASON-ARGS)

The DWIM checking operator. If TEST returns a true value a test-passed result is generated, otherwise a test-failure result is generated. The reason, unless REASON-ARGS is provided, is generated based on the form of TEST: (predicate expected actual) - Means that we want to check whether, according to PREDICATE, the ACTUAL value is in fact what we EXPECTED. (predicate value) - Means that we want to ensure that VALUE satisfies PREDICATE. Wrapping the TEST form in a NOT simply preducse a negated reason string.

IS-FALSE (CONDITION &REST REASON-ARGS)

Generates a pass if CONDITION returns false, generates a failure otherwise. Like IS-TRUE, and unlike IS, IS-FALSE does not inspect CONDITION to determine what reason to give it case of test failure

IS-TRUE (CONDITION &REST REASON-ARGS)

Like IS this check generates a pass if CONDITION returns true and a failure if CONDITION returns false. Unlike IS this check does not inspect CONDITION to determine how to report the failure.

SIGNALS (CONDITION-SPEC &BODY BODY)

Generates a pass if BODY signals a condition of type CONDITION. BODY is evaluated in a block named NIL, CONDITION is not evaluated.

Undocumented

TEST (NAME &BODY BODY)