diff --git a/doc/src/extras.rst b/doc/src/extras.rst index 0511c23f..710e9b5c 100644 --- a/doc/src/extras.rst +++ b/doc/src/extras.rst @@ -128,6 +128,8 @@ Additional data types --------------------- +.. _adapt-hstore: + .. index:: pair: hstore; Data types pair: dict; Adaptation @@ -157,6 +159,8 @@ can be enabled using the `register_hstore()` function. +.. _adapt-composite: + .. index:: pair: Composite types; Data types pair: tuple; Adaptation diff --git a/doc/src/index.rst b/doc/src/index.rst index 52e7dd2f..c593206e 100644 --- a/doc/src/index.rst +++ b/doc/src/index.rst @@ -4,20 +4,30 @@ Psycopg -- PostgreSQL database adapter for Python .. sectionauthor:: Daniele Varrazzo -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|_ 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. -The psycopg distribution includes ZPsycopgDA, a Zope_ Database Adapter. +The Psycopg distribution includes ZPsycopgDA, a Zope_ Database Adapter. -Psycopg 2 is an almost complete rewrite of the Psycopg 1.1.x branch. Psycopg 2 -features complete libpq_ v3 protocol, |COPY-TO-FROM|__ and full :ref:`object -adaptation ` for all basic Python types: strings (including unicode), ints, -longs, floats, buffers (binary objects), booleans, `mx.DateTime`_ and builtin -datetime types. It also supports unicode queries and Python lists mapped to -PostgreSQL arrays. +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 +`. 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, +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 +`. +Psycopg 2 is Unicode and Python 3 friendly. + + +.. _Psycopg: http://initd.org/psycopg/ .. _PostgreSQL: http://www.postgresql.org/ .. _Python: http://www.python.org/ .. _Zope: http://www.zope.org/