diff --git a/doc/src/index.rst b/doc/src/index.rst index f06582d9..5a4c42cb 100644 --- a/doc/src/index.rst +++ b/doc/src/index.rst @@ -4,12 +4,13 @@ Psycopg -- PostgreSQL database adapter for Python .. sectionauthor:: Daniele Varrazzo -Psycopg_ is a PostgreSQL_ database adapter for the Python_ programming -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 large number of concurrent :sql:`INSERT`\ s or :sql:`UPDATE`\ s. -The Psycopg distribution includes ZPsycopgDA, a Zope_ 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 |DBAPI|_ 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 :sql:`INSERT`\s or :sql:`UPDATE`\s. The Psycopg distribution +includes ZPsycopgDA, a Zope_ Database Adapter. 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 @@ -18,12 +19,13 @@ both efficient and secure. It features client-side and :ref:`server-side 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 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, between :ref:`dictionaries and -PostgreSQL hstores `, and between :ref:`tuples/namedtuples and -PostgreSQL composite types `. +(both byte strings and Unicode), numbers (ints, longs, floats, decimals), +booleans and date/time 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, between +:ref:`dictionaries and PostgreSQL hstore `, between +:ref:`tuples/namedtuples and PostgreSQL composite types `, +and between Python objects and :ref:`JSON `. Psycopg 2 is both Unicode and Python 3 friendly.