summaryrefslogtreecommitdiff
path: root/README.unittests
diff options
context:
space:
mode:
authorJason Kirtland <jek@discorporate.us>2008-01-23 18:26:50 +0000
committerJason Kirtland <jek@discorporate.us>2008-01-23 18:26:50 +0000
commitf980c5c88f616dddf51089dd37ee1023400c0a41 (patch)
treebc78bf837b074534f3f6e82edc5cd4e9b50ff921 /README.unittests
parentbc998a14a5d83b17ee8cf0b5551466b9e8385961 (diff)
downloadsqlalchemy-f980c5c88f616dddf51089dd37ee1023400c0a41.tar.gz
Added notes about 2.3 improvements
Diffstat (limited to 'README.unittests')
-rw-r--r--README.unittests23
1 files changed, 20 insertions, 3 deletions
diff --git a/README.unittests b/README.unittests
index aa1381017..37f477270 100644
--- a/README.unittests
+++ b/README.unittests
@@ -4,8 +4,9 @@ SQLALCHEMY UNIT TESTS
SETUP
-----
-Python 2.4 or greater is required, as the unit tests use decorators. SQLite
-support is required.
+SQLite support is required. These instructions assume standard Python 2.4 or
+higher. See the section on alternate Python implementations for information on
+testing with 2.3 and other Pythons.
The 'test' directory must be on the PYTHONPATH.
@@ -134,7 +135,6 @@ cool!
TESTING NEW DIALECTS
--------------------
-
You can use the SQLAlchemy test suite to test any new database dialect in
development. All possible database features will be exercised by default.
Test decorators are provided that can exclude unsupported tests for a
@@ -168,6 +168,23 @@ always possible. If you hit a wall, join us on the mailing list or, better,
IRC!
+ALTERNATE PYTHON IMPLEMENTATIONS
+--------------------------------
+The test suite restricts itself to largely Python 2.3-level constructs and
+standard library features, with the notable exception of decorators, which are
+used extensively throughout the suite.
+
+A source transformation tool is included that allows testing on Python 2.3 or
+any other Python implementation that lacks @decorator support.
+
+To use it:
+
+ $ python test/clone.py -c --filter=py23 test23
+
+This will copy the test/ directory structure into test23/, with @decorators in
+the source code transformed into 2.3-friendly syntax.
+
+
TIPS
----
Postgres: The tests require an 'alt_schema' and 'alt_schema2' to be present in