Added notes about 2.3 improvements

diff --git a/CHANGES b/CHANGES
index 0c79df7a8db285598452e058beb6f431820868b8..937bae302c86768084297a8ecccd2b09fd3c2548 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -109,6 +109,10 @@ CHANGES
     - Miscellaneous tickets: [ticket:940]
 
 - general
+    - Fixed a variety of hidden and some not-so-hidden
+      compatibility issues for Python 2.3, thanks to new
+      support for running the full test suite on 2.3.
+
     - Warnings are now issued as type exceptions.SAWarning.
 
 - dialects

diff --git a/README.unittests b/README.unittests
index aa13810177c97b86c5bebd9f66a6d0398cebea0f..37f47727024e9f21267bb1a11283e803b60d4725 100644 (file)
--- 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