From f980c5c88f616dddf51089dd37ee1023400c0a41 Mon Sep 17 00:00:00 2001 From: Jason Kirtland Date: Wed, 23 Jan 2008 18:26:50 +0000 Subject: [PATCH] Added notes about 2.3 improvements --- CHANGES | 4 ++++ README.unittests | 23 ++++++++++++++++++++--- 2 files changed, 24 insertions(+), 3 deletions(-) diff --git a/CHANGES b/CHANGES index 0c79df7a8d..937bae302c 100644 --- 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 aa13810177..37f4772702 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 -- 2.47.3