psycopg2

mirror of https://github.com/psycopg/psycopg2.git synced 2024-11-25 18:33:44 +03:00

PostgreSQL database adapter for the Python programming language

database driver postgresql python starred-psycopg-repo starred-repo

Go to file

Oleksandr Shulgin e32e1b834e Add support for streaming replication protocol Introduce ReplicationConnection and ReplicationCursor classes, that incapsulate initiation of special type of PostgreSQL connection and handling of special replication commands only available in this special connection mode. The handling of stream of replication data from the server is modelled largely after the existing support for "COPY table TO file" command and pg_recvlogical tool supplied with PostgreSQL (though, it can also be used for physical replication.)		2015-06-01 11:45:04 +02:00
doc	Add support for streaming replication protocol	2015-06-01 11:45:04 +02:00
examples	cleanup remaining GPL license text	2014-05-20 09:50:53 -07:00
lib	Add support for streaming replication protocol	2015-06-01 11:45:04 +02:00
psycopg	Add support for streaming replication protocol	2015-06-01 11:45:04 +02:00
sandbox	cleanup remaining GPL license text	2014-05-20 09:42:41 -07:00
scripts	Don't need to build the env for a sdist	2014-09-01 16:29:38 +01:00
tests	Fix several typos	2015-05-03 10:30:21 +01:00
.gitignore	Added scripts to release and upload docs	2014-09-01 16:29:38 +01:00
.travis.yml	Add .travis.yml for Travis CI (http://travis-ci.org/)	2012-06-15 08:07:19 -07:00
AUTHORS	Preparing release 2.3.0-beta1	2010-11-06 15:50:39 +01:00
INSTALL	Dropped content from the INSTALL file	2014-08-24 02:06:09 +01:00
LICENSE	Changes license to LGPL3 + OpenSSL exception on all source files	2010-02-12 23:34:53 +01:00
Makefile	Docs build process and docs cleaned up	2015-04-28 09:32:58 +01:00
MANIFEST.in	Added missing files needed to build the docs	2015-04-28 08:38:57 +01:00
NEWS	OpenSSL deadlock fix noted in NEWSfile	2015-05-03 12:27:37 +01:00
psycopg2.cproj	Dropped outdated HACKING file	2014-08-24 02:06:09 +01:00
psycopg2.sln	New 'withhold' parameter for connection.cursor()	2011-08-10 18:25:46 +02:00
README.rst	Direct link to the install docs in the readme	2014-08-24 23:33:14 +01:00
setup.cfg	Dropped HAVE_PQFREEMEM flag	2014-08-24 01:43:12 +01:00
setup.py	Bump to next dev version number for the master branch	2015-04-28 08:38:41 +01:00
tox.ini	Dropped Zope support	2012-12-03 02:53:20 +00:00

README.rst

psycopg2 - Python-PostgreSQL Database Adapter
=============================================

Psycopg is the most popular PostgreSQL database adapter for the Python
programming language.  Its main features are the complete implementation of
the Python DB API 2.0 specification and the thread safety (several threads can
share the same connection).  It was designed for heavily multi-threaded
applications that create and destroy lots of cursors and make a large number
of concurrent "INSERT"s or "UPDATE"s.

Psycopg 2 is mostly implemented in C as a libpq wrapper, resulting in being
both efficient and secure.  It features client-side and server-side cursors,
asynchronous communication and notifications, "COPY TO/COPY FROM" support.
Many Python types are supported out-of-the-box and adapted to matching
PostgreSQL data types; adaptation can be extended and customized thanks to a
flexible objects adaptation system.

Psycopg 2 is both Unicode and Python 3 friendly.


Documentation
-------------

Documentation is included in the 'doc' directory and is `available online`__.

.. __: http://initd.org/psycopg/docs/


Installation
------------

If all the dependencies are met (i.e. you have the Python and libpq
development packages installed in your system) the standard::

    python setup.py build
    sudo python setup.py install

should work no problem.  In case you have any problem check the 'install' and
the 'faq' documents in the docs or online__.

.. __: http://initd.org/psycopg/docs/install.html

For any other resource (source code repository, bug tracker, mailing list)
please check the `project homepage`__.

.. __: http://initd.org/psycopg/