diff --git a/doc/src/index.rst b/doc/src/index.rst index c593206e..906753e0 100644 --- a/doc/src/index.rst +++ b/doc/src/index.rst @@ -5,26 +5,27 @@ Psycopg -- PostgreSQL database adapter for Python .. sectionauthor:: Daniele Varrazzo 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 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. -Psycopg 2 features complete libpq_ v3 protocol, client-side and -:ref:`server-side ` cursors, :ref:`asynchronous -communication ` and :ref:`notifications `, -|COPY-TO-FROM|__ and a flexible :ref:`objects adaptation system +Psycopg 2 is mostly implemented in C as a libpq_ wrapper, resulting in being +both efficient and secure. It features client-side and :ref:`server-side +` cursors, :ref:`asynchronous communication +` and :ref:`notifications `, |COPY-TO-FROM|__ +support, and a flexible :ref:`objects adaptation system `. Many basic Python types are supported 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 :ref:`binary objects `. Also available are mappings between lists -and PostgreSQL arrays of any supported type, :ref:`dictionaries and PostgreSQL -hstore `, :ref:`tuples/namedtuples and PostgreSQL composite types -`. +and PostgreSQL arrays of any supported type, between :ref:`dictionaries and +PostgreSQL hstores `, and between :ref:`tuples/namedtuples and +PostgreSQL composite types `. -Psycopg 2 is Unicode and Python 3 friendly. +Psycopg 2 is both Unicode and Python 3 friendly. .. _Psycopg: http://initd.org/psycopg/