Initial documentation on runnin the horde_db test suite

diff --git a/framework/Db/doc/README.TESTING.txt b/framework/Db/doc/README.TESTING.txt
new file mode 100644 (file)
index 0000000..1a03a74
--- /dev/null
+++ b/framework/Db/doc/README.TESTING.txt
@@ -0,0 +1,32 @@
+====================
+ Horde/Db Test Suite
+====================
+
+:Last update:   2009-01-04
+:Authors:       Chuck Hagenbuch
+:Contact:       dev@lists.horde.org
+
+.. contents:: Contents
+.. section-numbering::
+
+Defining adapters
+=================
+
+As long as PHP has the PDO SQLite driver (which is enabled by default), the
+SQLite tests will always be run. This is possible using the sqlite:memory
+database; no file access or permissions are required.
+
+For the other adapters, the Horde_Db test suite looks for environment variables
+named HORDE_DB_TEST_DSN_$driverName. For the MySQLi driver, that would be
+HORDE_DB_TEST_DSN_MYSQLI. For the PDO PostgreSQL driver, that would be
+Horde_DB_TEST_DSN_PDO_PGSQL, and so on. The value of the environment variable is
+a JSON string with the configuration array for the adapter. Here is an example
+for setting up a test DSN for the MySQL test database on localhost, connecting
+as the user horde_db with no password:
+
+{"username":"horde_db","dbname":"test","host":"localhost"}
+
+When running the test suite, any adapter for which a DSN is not found, or for
+which connecting to the defined DSN fails, a single instance of
+Horde_Db_Adapter_MissingTest will be included in the test suite run, with
+details on why the adapter was skipped.

diff --git a/framework/Db/doc/TODO.txt b/framework/Db/doc/TODO.txt
index 8d3d25d..83d7819 100644 (file)
--- a/framework/Db/doc/TODO.txt
+++ b/framework/Db/doc/TODO.txt
@@ -1,7 +1,5 @@
 - port Rdo to run on Horde_Db
 
-- document running the test suite
-
 - port updates in schema_definitions.rb and schema_statements.rb
 
 - allow adding multiple indexes (and columns) at once, in an aggregate