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 

* PoPy supports multiple opened backends to speed up transactions with your
  multithreaded and multi cursors applications. 
  PoPy provides a new *connect* function.

	conx = PoPy.connect('your connection string', num_of_backend)

  num_of_backend is an integer, right now PoPy handles only 10 backends max.
  Putting less than 1 or greater than 10, sets num_of_backend to 1.

* PoPy allows to create groups of cursors to share the same backend. For 
  example, you could set a group of cursors to execute updates only.
  Here an example how you can use this feature:

	conx = PoPy.connect('user=your_user dbname=your_db host=your_host',2)
	cur1 = conx.cursor() # father of cursors group on backend 1
	cur2 = conx.cursor(cur1) # cur2 is the son of cur1

  cur1 and cur2 work on the same backend, committing the backend commits all
  cursors working on this backend !

* To commit or rollback a specific transaction (or cursor) PoPy provides a new
  commit/rollback functions, for example:

	conx = PoPy.connect(...
	...
	cur1.execute('insert into foo values(1,2,3,4)')
	# to commit *only* the transaction of cur1
	conx.commit(cur1)

	# to commit all transactions 
	conx.commit()

	# to rollback *only* the transaction of cur1
	conx.rollback(cur1)

	# to rollback all transactions
	conx.rollback()		
 
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.


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".

Enjoy.

The PoPy team
