+* RUNNING THE REGRESSION SUITE
+
+Just load clsql.asd or put it somewhere where ASDF can find it
+and call:
+
+(asdf:oos 'asdf:load-op 'clsql)
+
+You'll then need to load a CLSQL backend before you can do anything.
+
+To run the regression tests load clsql-tests.asd or put it
+somewhere where ASDF can find it, edit the file tests/test-init.lisp
+and set the following variables to appropriate values:
+
+ *test-database-server*
+ *test-database-name*
+ *test-database-user*
+ *test-database-password*
+
+And then call:
+
+(asdf:oos 'asdf:load-op 'clsql-tests)
+(clsql-tests:run-tests BACKEND)
+
+where BACKEND is the CLSQL database interface to use (currently one of
+:postgresql, :postgresql-socket, :sqlite or :mysql).
+
* REGRESSION TEST SUITE GOALS
The intent of this test suite is to provide sufficient coverage for
Refactoring and redesign efforts are normally restricted to a single
subsystem, or perhaps to interdependent subsystems. In such cases, a
set of regression tests which excercise the existing interface of the
-rest of USQL to the changing subsystems should be in place and passing
+rest of CLSQL to the changing subsystems should be in place and passing
before the coding starts.
** Ensuring portability and Supporting new ports.
** Adding new RDBMS backends
-The entire USQL DBMS interface needs to be excercised by the test
+The entire CLSQL DBMS interface needs to be excercised by the test
suite, such that a new RDBMS backend that passes all the tests can be
-reasonably assured of working with the USQL layers above that. These
+reasonably assured of working with the CLSQL layers above that. These
tests should also serve as impromptu documentation for the details of
that interface and what it expects frothe RDBMS driver layers.
** Multiple RDBMS Issues
-USQL supports several RDBMS backends, and it should be possible to run
+CLSQL supports several RDBMS backends, and it should be possible to run
every test against all of them. However, there are some features
which we want tests for but which are not implemented on several of
the backends.
*** Object Create/Modification/Deletion in a context -- partly covered already
*** Interaction of multiple contexts
*** Schema manipulation within a context
- *** Rollback and error handling within a context
\ No newline at end of file
+ *** Rollback and error handling within a context