Skip to content

Commit

Permalink
Updated the instructions of adding testsuite adapter in README.org
Browse files Browse the repository at this point in the history
  • Loading branch information
avodonosov committed Oct 22, 2012
1 parent 31a0667 commit 8d0248c
Showing 1 changed file with 22 additions and 8 deletions.
30 changes: 22 additions & 8 deletions README.org
Expand Up @@ -306,16 +306,30 @@

- ...

** Adding testsuite of your library
It is quite easy - few lines of code.
** Adding testsuites of your library

It's necessary to contact the cl-test-grid mailing list
and add a method for the =libtest= generic function to this file:
[[https://github.com/cl-test-grid/cl-test-grid/blob/master/testsuites/testsuites.lisp][testsuites/testsuites.lisp]]. The =libtest= function converts
results of library test suite to a unified format
understood by test-grid.

If you use some of the popular CL test frameworks,
the implementation is usually simple, like this:

#+BEGIN_SRC common-lisp
(defmethod libtest ((library-name (eql :cl-containers)))
;; The test framework used: lift.
(quicklisp:quickload :cl-containers-test)
(run-lift-test-suite :cl-containers-test))
#+END_SRC

Look how the library tests are started in the asdf:perform method
for asdf:test-op defined in the library .asd file. Then use the
same approach to define a method test-grid::libtest eql specialized
for that library and send us this code.
If you are not the library author and don't know how
it's test suite is run, look how the library tests are
started in the =asdf:perform= method for =asdf:test-op=
defined in the library .asd file.

See examples for the already added libraries in the
[[https://github.com/cl-test-grid/cl-test-grid/blob/master/testsuites/testsuites.lisp][testsuites/testsuites.lisp]].
In any case, contact the mailing list, we will help.

** More
Lot of things may be done in this project. But the project
Expand Down

0 comments on commit 8d0248c

Please sign in to comment.