MIME-Version: 1.0
From: Daniele Varrazzo <daniele.varrazzo@gmail.com>
Date: Fri, 13 Nov 2020 16:34:37 +0000
Message-ID: 
 <CA+mi_8auX2vz6i+E74bxOC7hFcGDQzBAY3GypUBkAK+NveFtfQ@mail.gmail.com>
Subject: First psycopg3 docs
To: psycopg@postgresql.org
Content-Type: text/plain; charset="UTF-8"
Precedence: bulk

Hello,

I have started writing down the documentation for psycopg3,
highlighting some of the differences and the new features available in
this new project.

https://www.psycopg.org/psycopg3/docs/

There is a rough cut of the API of the Connection and Cursor objects
and their asyncio counterparts, and some description about the new
`cursor.copy()` feature, which now interacts with Python objects, not
only with file objects as in psycopg2, and the new ways to receive
asynchronous notifications.

https://www.psycopg.org/psycopg3/docs/usage.html#copy
https://www.psycopg.org/psycopg3/docs/usage.html#asynchronous-notifications

As you probably know, I started this project a few months ago, with
the intention of crowdfunding its development. I am very grateful with
the people who have sponsored the project so far, especially because
in the previous months I had other projects to work on too, and
psycopg3 had to simmer on the back burners for some time.

A few weeks ago I finished the contract which was keeping me busy and
now I have resources to develop psycopg3 as my main activity: I am
planning to keep it this way at least for a few other months, which
should be enough to release the project. It is not my plan to keep
this as a one-man show, so if someone would like to contribute to the
project you are more than welcome.

If you are a professional using Python and PostgreSQL and would like
to enjoy a new generation of Psycopg to work with, or if you want to
make sure that the new project will cater for your needs, your
sponsorship of the project will be invaluable: you can read more at
https://www.psycopg.org/psycopg3/

Thank you very much!

-- Daniele