;; $Id$

To run the test scripts in test/ you need a Python extension module called
"MySQLdb".  You can get the source here:

http://sourceforge.net/projects/mysql-python

INSTALLATION INSTRUCTIONS
=========================

Lines beginning with "$" indicate example commands to execute the instructed
step.

The `shared module' options build a shared library for the Python-MySQLdb
module that is loaded at Python run-time.  This requires that you have a
shared version of the MySQL client library installed, i.e. libmysqlclient.so.

Debian Linux: shared module
---------------------------
    1. Install
       $ apt-get install python-mysqldb
    
    [ 2003/07: if you have both Python 2.1 and 2.2 installed and use python2.2, do
       $ apt-get install python2.2-mysqldb
    ]

Red Hat Linux: shared module
----------------------------
    1. Download MySQL-python
       $ wget http://easynews.dl.sourceforge.net/sourceforge/mysql-python/MySQL-python-0.9.2-1.i386.rpm
    2. Install
       $ rpm (arguments?) 

Other Unix/Linux: shared module
-------------------------------
    1. Download MySQL-python
       $ wget http://easynews.dl.sourceforge.net/sourceforge/mysql-python/MySQL-python-0.9.2.tar.gz
    2. Unpack
       $ gunzip -c MySQL-python-0.9.2.tar.gz | tar xf -
       $ cd MySQL-python-0.9.2
    3. Build
       $ python setup.py build
    4. Install
       $ python setup.py install

Unix/Linux: compiled statically into Python
-------------------------------------------
    1. Download MySQL-python
       $ wget http://easynews.dl.sourceforge.net/sourceforge/mysql-python/MySQL-python-0.9.2.tar.gz
    2. Unpack
       $ gunzip -c MySQL-python-0.9.2.tar.gz | tar xf -
    3. Download Python
       $ wget http://python.org/ftp/python/2.3/Python-2.3.tgz   
    4. Unpack
       $ gunzip -c Python-2.3.tgz | tar xf -
       $ cd Python-2.3
    5. Copy MySQL files
       $ cp ../MySQL-python-0.9.2/{*c,*.h} Modules/
    6. Configure python
       $ ./configure --prefix=/path/to/install/python
    7. Modify the Python module setup file.
       $ vi Modules/Setup
    
       Find 'sre _sre.c' and add below it:
         _mysql _mysql.c -I/usr/include/mysql -I/usr/local/mysql/include -L/usr/local/mysql/lib -lmysqlclient
    
       If those -I and -L flags don't work you can find the correct ones using
       the program `mysql_config'
    8. Build
       $ make
    9. Install
       $ make install

Windows: pre-packaged binary
----------------------------
    There is a built python executable available at the URL listed.

Does it work?
=============
    You can check if your MySQLdb was compiled correctly like this:
    
    $ cd ../Python-MySQLdb-0.9.2
    $ ../Python-2.3/python
    >>> import MySQLdb
    >>> MySQLdb.connect(db='databasename', user='username')