Added notes about 2.3 improvements

This commit is contained in:
Jason Kirtland 2008-01-23 18:26:50 +00:00
parent bc998a14a5
commit f980c5c88f
2 changed files with 24 additions and 3 deletions

View File

@ -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

View File

@ -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