                                            _ _ _       
                      _ __  _   _ ___  __ _| (_) |_ ___ 
                     | '_ \| | | / __|/ _` | | | __/ _ \
                     | |_) | |_| \__ \ (_| | | | ||  __/
                     | .__/ \__, |___/\__, |_|_|\__\___|
                     |_|    |___/        |_|            

               A DB API v2.0 compatible interface to SQLite
                       Embedded Relational Database.
                          Copyright (c) 2001-2003
                   Michael Owens <mike@mikesclutter.com>
                      Gerhard Hring <gh@ghaering.de>


This module was inspired by MySQLdb Python interface to MySQL. Much of the
initial source code related to Python extension writing in this module was done
with the help of MySQLdb. Many thanks to Andy Dustman for his excellent work
with MySQLdb, and Gerhard Haring for his direct contributions to this project in
both experience and code from his work on the pypgsql extension.

Overview:

This is an extension module for the SQLite embedded relational database. It
tries to conform to the Python DB-API Spec v2 as far as possible. One problem
is that SQLite returns everything as text. This is a result of SQLite's
internal representation of data, however it still may be possible to return
data in the type specified by the table definitions. I am still working on
that, and will require some study of the SQLite source.

Installation:

Installation should be relatively simple. Following that prescribed by Python,
it can be done in two steps:

    python setup.py build
    python setup.py install

Other:

Check out the examples folder. There are three examples and some test data. The
README file explains everything.

I would like to thank Andy Dustman for his excellent contribution in MySQLdb. It
was a great help in my indoctrination in writing Python extenions modules. I
have also been using MySQLdb for a production website for about a year now, and
my boss is very happy. Thank you Andy. You helped win a business over to Linux.

And of course thanks to D. Richard Hipp, for writing SQLite. It is a work of art
and a wonderful contribution to the open source community.

I hope this might help others in the same way.

As they say at SuSE: Have a lot of fun.
