Update domain name to kpe.io
[clsql.git] / tests / README
index 51876c19c1932074c0fda8a0f1c783bd786217b4..aa6a9a691119a30cbab7362d54ff214d5a54f1af 100644 (file)
@@ -1,28 +1,21 @@
 * 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. 
+This test suite looks for a configuration file named
+".clsql-test.config" located in the users home directory. This file
+contains a single assoc-list that specifies the connection specs for
+each database type to be tested. There is an example file in
+contained in CLSQL's examples directory.
 
-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:
+These tests require the downloading of the rt package from
+http://files.kpe.io/.
 
-    *test-database-server*
-    *test-database-name*
-    *test-database-user*
-    *test-database-password* 
-
-And then call:
+Load clsql.asd or put it somewhere where ASDF can find it
+and call:
 
-(asdf:oos 'asdf:load-op 'clsql-tests)
-(clsql-tests:run-tests BACKEND)
+(asdf:oos 'asdf:test-op 'clsql)
 
-where BACKEND is the CLSQL database interface to use (currently one of
-:postgresql, :postgresql-socket, :sqlite or :mysql).
+The test suite will then automatically run on all of the backends that
+you have defined in .clsql-test.config
 
 * REGRESSION TEST SUITE GOALS
 
@@ -106,9 +99,9 @@ will be run.
    *** Error if existing DB
 
 ** Data Definition
-  *** Create Tables/Sequences/Indexes -- Should cover creation of
+  *** Create Tables/Views/Sequences/Indexes -- Should cover creation of
       tables with all supported types of fields.
-  *** Delete Tables/Sequences/Indexes
+  *** Delete Tables/Views/Sequences/Indexes
   *** Inspection of Tables and attributes, including types
 
 ** Data Manipulation
@@ -129,8 +122,3 @@ will be run.
   *** Object creation/manipulation/deletion
   *** Inter-object Relations
 
-** Editing Contexts
-  *** 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