[Zope-Checkins] CVS: Products/DCOracle2 - README:1.10

[Chris Withers]

Update of /cvs-repository/Products/DCOracle2
In directory cvs.zope.org:/tmp/cvs-serv21346

Modified Files:
	README 
Log Message:
Added documentation for running the tests.


=== Products/DCOracle2/README 1.9 => 1.10 ===
--- Products/DCOracle2/README:1.9	Tue Jan 29 11:35:53 2002
+++ Products/DCOracle2/README	Wed Oct 29 11:48:38 2003
@@ -122,3 +122,63 @@
 Currently, the code will emit the error message returned to STDOUT, but
 otherwise continue execution.  For SELECT statements, there is no good way
 to signal the error condition to the application.
+
+RUNNING THE TESTS:
+
+This package includes test suites for both DCOracle2 and ZOracleDA.
+To run these test suites you need to do the following:
+
+1. Get access to an Oracle database for testing. This database should
+   not contain any data as the tests may well destroy it. You have been 
+   warned!
+
+2. Run the scott.sql and procdef.sql scripts found in the 'test' folder
+   of this distribution to set up the required tests environment.
+   These scripts must be run as a system user.
+
+   This can be done using sqlplus as follows:
+
+   $ sqlplus
+
+   Enter user-name: username/password at database
+
+   SQL> @ scott.sql
+   No errors.
+
+   SQL> @ procdef.sql
+   SQL> SET TERMOUT OFF
+   No errors.
+   No errors.
+   No errors.
+   No errors.
+   No errors.
+   No errors.
+   No errors.
+
+3. Set the ORACLE_HOME environment to the location of your
+   Oracle installation.
+
+   eg:
+   
+   $ export ORACLE_HOME=/opt/oracle/product/8.1.7
+
+4. Set the DCORACLE_TEST_CONNSTRING environment variable to the 
+   connection string for your test database.
+
+   eg:
+
+   $ export DCORACLE_TEST_CONNSTRING=username/password at database
+
+   The user here need not be a system user but must full rights
+   to use and alter the database.
+
+Once the above has been done, the test suites may be run.
+
+To run the DCOracle2 test suite, execute the test_dcoracle2.py
+script in the test folder of this distribution.
+
+eg:
+
+$ pwd
+/site_packages/DCOracle2/test
+$ python test_dcoracle2.py