/SQLAlchemy-0.7.8/README.py3k

 1=================
 2PYTHON 3 SUPPORT
 3=================
 4
 5Current Python 3k support in SQLAlchemy is provided by a customized
 62to3 script which wraps Python's 2to3 tool.
 7
 8Installing Distribute
 9---------------------
10
11Distribute should be installed with the Python3 installation.  The
12distribute bootloader is included.
13
14Running as a user with permission to modify the Python distribution,
15install Distribute:
16
17    python3 distribute_setup.py
18
19
20Installing SQLAlchemy in Python 3
21---------------------------------
22
23Once Distribute is installed, SQLAlchemy can be installed directly.
24The 2to3 process will kick in which takes several minutes:
25
26    python3 setup.py install
27
28Converting Tests, Examples, Source to Python 3
29----------------------------------------------
30
31To convert all files in the source distribution, run 
32SQLAlchemys "sa2to3.py" script, which monkeypatches a preprocessor
33onto the 2to3 tool:
34
35    python3 sa2to3.py --no-diffs -w lib test examples
36
37The above will rewrite all files in-place in Python 3 format.
38
39Running Tests
40-------------
41
42To run unit tests in Py3k, Nose 1.0 is required, or a development
43version of Nose that supports Python 3.   The tests are run
44using ./sqla_nose.py as described in README.unittests.
45
46Current 3k Issues
47-----------------
48
49Current bugs and tickets related to Py3k are on the Py3k milestone in trac:
50
51http://www.sqlalchemy.org/trac/query?status=new&status=assigned&status=reopened&milestone=py3k
52