Implement connection/cursor procedures as generators

Generators are common to both sync and async code so there is much less
code duplication, which will be useful in the light of doing more
complex things such as prepared transactions.

As a side effect of the refactoring, operations on closed connections
are raised as OperationalError rather than InterfaceError because
connection closure may depend on external factors.

Dropped fd from PQGen stream: the having the fd in the middle of the
`Ready` values made more difficult to chain more than one operation in
the same generator. The fd is not passed as extra parameter.

Register automatically the array loader on all the builtins

Also added reg* types to the known builtins. This way regtype[] is
loaded as a list of strings.

Better use of Cython public properties

Enable cython faster call convention

Release the gil around functions known to be slow

Profiling some time ago showed that these functions take relevant time.
Other paths will be reviewed.

https://www.varrazzo.com/blog/2020/05/19/a-trip-into-optimisation/

Added website to sponsors file

Added @postgrespro sponsor!

Thank you Oleg!

Added _oid C attribute to CDumper

Reduce re-allocations in objects quoting

Fixed broken previous commit

escape_string, escape_identifier use buffers too

Make wider use of Composite.as_bytes

Added buffer object to wrap libpq memory

Several code paths extended to deal with objects implementing the buffer
protocol instead of just bytes: this allows to perform less memory copy.

Added sql.Composable.as_bytes method to use in preference of as_string
(you may do without decoding altogether).

Added bytearray and memoryview dumpers

Also manage these objects when they rich the libp param passing.

Dropped use of a couple of constants in json

Added docs about string/binary adaptation

Sponsorship by @commandprompt - Thank you very much @jdatcmd

Added @mailupinc sponsor. Thank you!

Sponsorship by @phenopolis from @pontikos

Thank you very much, Niko!

Updated sponsorship by @gporcari @genropy

Grazie tantissime, Giovanni!

Backers file converted to yaml

It will be displayed at https://www.psycopg.org/sponsors/

Added several range tests and fixed a pasto error

Merge branch 'range-adaptation'

Added range type fetching and registration

Fixed quoting of [ ] chars for range types: unlike for composite they
need quoting.

Fetch/register composite made methods of a CompositeInfo class.

Added builtin ranges adaptation

Added `conection.execute()` method

Composite record parsing made independent from the "()" terminators

This should make this code useful to parse range representations too,
which may use a mix of () and [] terminators.

@Intevation is sponsoring psycopg3, thank you :)

Fixed escaping of a few chars in composite dumping

Fixed composite info fetch with homonymous types

Use a fully qualified name, optionally expressed as sql.Identifier, to
find the type in the right schema.

Installation and readme improvements

Dropped erroneous statement that psycopg3 quotes values

Added backer @bernhardreiter, thank you!

Small tweaks to add_backer script

Backers file updated

Added scripts to help maintaining it.

Fixed COPY statement suggesting it accepts parameters

It was, it just didn't work... :P

Fixed testing for diag properties on Pg < 9.6

Separate generators where the fd can change from the ones where not

This should make the query operation marginally faster.

Make sure Notify is hashable

Added a few tests from the psycopg2 test suite

Raise the correct error (diag and all) on commit error

Also added other error-related tests from psycopg2 test suite.

Fixed sdist package for psycopg3-c

`types` made into a package so that the setup.py is able to find the
Cython sources there.

Fixed links in error docs, uniform DB-API spelling

Dropped executable flag from test

Added missing file headers

Added test to check rowcount works after execmany returning tuples

Cursor.description can be pickled

Include typing information in packages

Dumper and Loader made abstract classes

Dropped register_binary() method from Loader and Dumper

Use the format parameter on register(): documented and made public.

Main interest point in docs landing page

Fixed doc ref

Fix #16 Use svg logo in documentation

Windows compatibility for tests

* Skip test_connect_timeout() on Windows for the time being as
  Connection.connect() hangs for some reason. This skip can probably
  go away once connection timeouts are implemented.
* test_multiprocess_close(): Turn LocalPath instance back into a str
  before putting it back into env["PYTHONPATH"] to avoid failure in:
  _winapi.CreateProcess(): TypeError: environment can only contain str

Maybe unbreak website generation on travis

Added a main level to the docs

Docs split in several page with better visibility of titles.

Also adding a sort of narrative with several cross links between topics.

More contrasty pygment style

Uppercase admonitions in docs

With the furo theme it's pretty clear that they are at the start of a
sentence.

Merge branch 'docs-furo'

Take docs announcement out of repos

Moved to the website.

Furo style tweaked

- non smaller font in admonitions
- rubric styled.

Fix #13 Use a responsive docs theme

Adapt find_library() call to find libpq.dll on Windows

Raise TypeError attempting to use a Copy context more than once

See #10

Make sure transaction blocks cannot be used more than once

See #12

Fix docs generation to avoid getting confused by __module__ rewritten

Autodoc features which need the original module get confused, so e.g. pq
enum members or Notify attribute docs are lost if not fixed.

Other classes have their __module__ specified

These required jumping through hoop to have mypy and documentation
agreeing, now it's more natural.

pq enums __module__ changed to psycopg3.pq

I have found cases of its writability in the stdlib, so I'm satisfied it
can be done.

Import pq enums in modules where they are used

Call the params params, not vars

Queries modume moved out of utils package

Added some docs about adaptation

Fixed broken tests after fixing async connection discrepancies

Fixed tiny diffreences in behaviour between sync and async code

Remove obsolete references to Transaction.Rollback

Rollback exception is no longer available on the Transaction object.

Added Cursor.query and params.

Dropped params from Cursor.copy()

Never tested... and they don't work.

Added some documentation on the adaptation system

Added initial docs for psycopg3.pq module

Added installation instructions including the binary package

Use the build script to build source packages too

Create the psycopg3-binary package

Added in-progress script to build wheel packages

Pure Python implementation called 'python', not 'ctypes'

Use "pip install psycogp3[c]" to install the C extension

Merge branch 'c-dumpers'

Cursor.callproc dropped

The method has a simplistic semantic which doesn't account for
PostgreSQL positional parameters, procedures, set-returning functions.
Users can use a normal `Cursor.execute()` with SELECT
function_name(...)` or CALL procedure_name(...)` instead.

Api docs and typing system made consistent

Top-level objects are annotated as coming from the main package: this
way the documentation can link them consistently to where they are
documented (e.g. `Connection` is `psycopg3.Connection`, not
`psycopg3.connection.Connection`) and MyPy is happy too.

Cursor.connection made a read-only property

Dropped "-> None" from function returning no result in docs

Added errors module documentation

Added documentation for the `sql` module

Added C string dumpers

C Dumpers and Loaders attributes readable from Python

Use the right class instantiating a dumper on a subclass

Added oid constants in cython extension

Added C bool dumpers (text, binary)

Added C implementation of int dumpers (text, binary)

s/loaders/adapters/ where there will be dumpers too