PoPy - Python Driver for PostgreSQL
===================================
This is PoPy, a driver for PostGresql v7.x
to use with python (www.python.org), release under the GNU GPL license.

Features:
--------

* DB API v2.0 compliant (http://www.python.org/topics/database/DatabaseAPI-2.0.html)
* Thread safety level 2
* Support for large objects and date objects 
* External and internal database procedure call 

Obtaining it:
------------

You can get the PoPy driver at:

	ftp://popy.sourceforge.net/pub/popy/

	http://sourceforge.net/projects/popy

Installing:
----------

See the 'INSTALL' file.


About Connection Object.
------------------------

The actual connect() function uses a connection string. But the PoPy Team
planned to change it to be *really* DB-API 2.0 compliant.

conx = connect('user=user_name dbname=db_name host=host_name port=5432')

Note: This connection string will be changed in the next 3.0 release.

Some arguments could be missed, so PoPy takes defaults.

MailingList: 
-----------

Mailing lists are now avalaible on sourceforge web site at :

	http://lists.sourceforge.net/mailman/listinfo/popy-user	
	http://lists.sourceforge.net/mailman/listinfo/popy-devel	
	http://lists.sourceforge.net/mailman/listinfo/popy-announce	


CVS:
---

to get the latest CVS version :

cvs -d:pserver:anonymous@cvs.popy.sourceforge.net:/cvsroot/popy login
cvs -z3 -d:pserver:anonymous@cvs.popy.sourceforge.net:/cvsroot/popy co popy

Compilation Problems:
-------------------

Some of you may experienced problems when compiling PoPy: "<catalog/pg_types.h> not found"
We use this include to avoid magic numbers. if you have this type of problems,
grab pg_types.h from postgresql source tree and put it in "/usr/include/catalog".


Python 2.x compilation.
-----------------------

If you have 2 versions of python on your box, you have to specify which version of python
you want to use for the compilation.

So, write, ./configure --with-python-version=2.0 to compile with the 2.0 version.

Note: The default used version is 1.5 !!!

Enjoy.

The PoPy team
