2014-08-22 09:08:38 +04:00
|
|
|
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
|
|
|
|
|
------------
|
|
|
|
|
|
2017-02-16 20:17:13 +03:00
|
|
|
If your ``pip`` version supports wheel_ packages it should be possible to
|
|
|
|
|
install a binary version of Psycopg including all the dependencies. Just run::
|
|
|
|
|
|
|
|
|
|
pip install psycopg2
|
|
|
|
|
|
|
|
|
|
If you want to build Psycopg from source you will need some prerequisite (a C
|
|
|
|
|
compiler, Python and libpq development packages). If you have what you need
|
|
|
|
|
the standard::
|
2014-08-22 09:08:38 +04:00
|
|
|
|
|
|
|
|
python setup.py build
|
|
|
|
|
sudo python setup.py install
|
|
|
|
|
|
|
|
|
|
should work no problem. In case you have any problem check the 'install' and
|
2014-08-25 02:33:14 +04:00
|
|
|
the 'faq' documents in the docs or online__.
|
|
|
|
|
|
2017-02-16 20:17:13 +03:00
|
|
|
.. _wheel: http://pythonwheels.com/
|
|
|
|
|
.. __: http://initd.org/psycopg/docs/install.html#install-from-source
|
2014-08-22 09:08:38 +04:00
|
|
|
|
|
|
|
|
For any other resource (source code repository, bug tracker, mailing list)
|
|
|
|
|
please check the `project homepage`__.
|
|
|
|
|
|
|
|
|
|
.. __: http://initd.org/psycopg/
|
2016-12-24 06:28:34 +03:00
|
|
|
|
|
|
|
|
|
2017-02-16 18:59:37 +03:00
|
|
|
:Linux/OSX: |travis|
|
|
|
|
|
:Windows: |appveyor|
|
|
|
|
|
|
|
|
|
|
.. |travis| image:: https://travis-ci.org/psycopg/psycopg2.svg?branch=master
|
2016-12-24 06:28:34 +03:00
|
|
|
:target: https://travis-ci.org/psycopg/psycopg2
|
2017-02-16 18:59:37 +03:00
|
|
|
:alt: Linux and OSX build status
|
|
|
|
|
|
2017-02-24 04:49:45 +03:00
|
|
|
.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/github/psycopg/psycopg2?branch=master&svg=true
|
2017-02-16 18:59:37 +03:00
|
|
|
:target: https://ci.appveyor.com/project/psycopg/psycopg2
|
|
|
|
|
:alt: Windows build status
|
