psycopg/psycopg2
1
1
Fork 0
mirror of https://github.com/psycopg/psycopg2.git synced 2025-01-31 09:24:07 +03:00
Code Issues Packages Projects Releases Wiki Activity

Improvements to the docs homepage after Bucko's proofreading

Browse Source
This commit is contained in:
Daniele Varrazzo 2011-12-15 22:13:20 +00:00
parent 9e8fc349b9
commit c3914b8aa2
1 changed files with 12 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
doc/src/index.rst
View File

@ -5,26 +5,27 @@ Psycopg -- PostgreSQL database adapter for Python
.. sectionauthor:: Daniele Varrazzo <daniele.varrazzo@gmail.com> .. sectionauthor:: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Psycopg_ is a PostgreSQL_ database adapter for the Python_ programming Psycopg_ is a PostgreSQL_ database adapter for the Python_ programming
language. Its main advantages are that it supports the full Python |DBAPI|_ language. Its main features are that it supports the full Python |DBAPI|_
and it is thread safe (threads can share the connections). It was designed for and it is thread safe (threads can share the connections). It was designed for
heavily multi-threaded applications that create and destroy lots of cursors and heavily multi-threaded applications that create and destroy lots of cursors and
make a conspicuous number of concurrent :sql:`INSERT`\ s or :sql:`UPDATE`\ s. make a large number of concurrent :sql:`INSERT`\ s or :sql:`UPDATE`\ s.
The Psycopg distribution includes ZPsycopgDA, a Zope_ Database Adapter. The Psycopg distribution includes ZPsycopgDA, a Zope_ Database Adapter.
Psycopg 2 features complete libpq_ v3 protocol, client-side and Psycopg 2 is mostly implemented in C as a libpq_ wrapper, resulting in being
:ref:`server-side <server-side-cursors>` cursors, :ref:`asynchronous both efficient and secure. It features client-side and :ref:`server-side
communication <async-support>` and :ref:`notifications <async-notify>`, <server-side-cursors>` cursors, :ref:`asynchronous communication
|COPY-TO-FROM|__ and a flexible :ref:`objects adaptation system <async-support>` and :ref:`notifications <async-notify>`, |COPY-TO-FROM|__
support, and a flexible :ref:`objects adaptation system
<python-types-adaptation>`. Many basic Python types are supported <python-types-adaptation>`. Many basic Python types are supported
out-of-the-box and mapped to matching PostgreSQL data types, such as strings out-of-the-box and mapped to matching PostgreSQL data types, such as strings
(both bytes and Unicode), numbers (ints, longs, floats, decimals), booleans, (both bytes and Unicode), numbers (ints, longs, floats, decimals), booleans and
datetime objects (both built-in and `mx.DateTime`_), several types of datetime objects (both built-in and `mx.DateTime`_), several types of
:ref:`binary objects <adapt-binary>`. Also available are mappings between lists :ref:`binary objects <adapt-binary>`. Also available are mappings between lists
and PostgreSQL arrays of any supported type, :ref:`dictionaries and PostgreSQL and PostgreSQL arrays of any supported type, between :ref:`dictionaries and
hstore <adapt-hstore>`, :ref:`tuples/namedtuples and PostgreSQL composite types PostgreSQL hstores <adapt-hstore>`, and between :ref:`tuples/namedtuples and
<adapt-composite>`. PostgreSQL composite types <adapt-composite>`.
Psycopg 2 is Unicode and Python 3 friendly. Psycopg 2 is both Unicode and Python 3 friendly.
.. _Psycopg: http://initd.org/psycopg/ .. _Psycopg: http://initd.org/psycopg/