Merge remote-tracking branch 'origin/pycurl' into planetlab-4_0-branch
[plcapi.git] / psycopg2 / README
1 psycopg - Python-PostgreSQL Database Adapter
2 ********************************************
3
4 psycopg is a PostgreSQL database adapter for the Python programming
5 language. This is version 2, a complete rewrite of the original code to
6 provide new-style classes for connection and cursor objects and other
7 sweet candies. Like the original, psycopg 2 was written with the aim of
8 being very small and fast, and stable as a rock.
9
10 psycopg is different from the other database adapter because it was
11 designed for heavily multi-threaded applications that create and destroy
12 lots of cursors and make a conspicuous number of concurrent INSERTs or
13 UPDATEs. psycopg 2 also provide full asycronous operations for the really
14 brave programmer.
15
16 There are confirmed reports of psycopg 1.x compiling and running on Linux
17 and FreeBSD on i386, Solaris, MacOS X and win32 architectures. psycopg 2
18 does not introduce build-wise incompatible changes so it should be able to
19 compile on all architectures just as its predecessor did.
20
21 Now go read the INSTALL file. More information about psycopg extensions to
22 the DBAPI-2.0 is available in the files located in the doc/ direcory.
23
24 psycopg is free software ("free as in freedom" but I like beer too.)
25 Licensing information is available in the LICENSE file.
26
27
28 Contributors
29 ------------
30
31 A short list of contributors to psycopg2 follows (if you feel you belong
32 to this list and you can't find yourself here just drop me a mail):
33
34  * Kudos to piro for all the documentation work.
35
36  * Peter Fein contributed a logging connection/cursor class that even if it
37    was not used directly heavily influenced the implementation currently in
38    psycopg2.extras.
39