Fix returning connection params in get_parameters() with empty default

"options" and "tty" were returned even if they were set to their
default.

Test that the row_cursor param can be set explicitly to none

Make sure to store read_only and deferrable values as bool

Add test to verify errors in row factories are handled ok

Fix a typo in transaction control docs

Merge branch 'async-row-factory'

Drop AnyCursor from public interface

Name repurposed internally for the generic to represent the type of
"self" in cursors.

Improve rows docs

Drop row_factory from base connection class

Move it to the sync/async concrete classes, specifying the right type.

Add AsyncRowFactory class

The extra class allow clients to define their RowFactory just taking a
Cursor or an AsyncCursor, which is easier if the program handles only
one type of connection (sync or async).

Using a Generic, the server-side cursors are now subclassed from  the
respective client-side cursor (sync and async), which allows to drop a
bit of implementation duplication.

Add StrDumper to dump strings with text oid

Don't clear the cursor state after closing

It might be still useful to access the cursor state (e.g. rowcount, the
status message) after the cursor is closed, especially if the block
syntax is used.

Memory use is not really a problem: memory is cleared on GC anyway and
most functions using a cursor don't rely on the memory freed between
close() and the end of the function.

Increase tolerance in float4 tests

The default tolerance is not quite enough on Postgres < 12 (e.g.
-13.633 != pytest.approx(-13.63298) with the default tolerance of 1e-6)

Add Float4/Float8 wrappers

Also improved numeric wrapper repr and made them lighter avoiding a dict
creation.

Skip testing with lists of floats.

There might be rounding problems and problems with inf.

Fix Bit.io url in backers file

Docs pool cleanup

Allow some form of dumping lists of mixed types

Lists of numbers are now dumped as numeric[].

Default to dump text for arrays.

Add Error.sqlstate as a static attribute

Allow to lookup the mapping const name -> sqlstate too, and lookup is
case insensitive.

Fix quote of Binary wrapper

Emit quoted values valid for every standard_conforming_string value

Work around the unpredictable return value from the libpq.

Fix bytes quoting with non standard conforming strings

Make sure the conn.autocommit attribute is set to a bool

Fix docs typo

Fix idempotence of server side cursors close()

More readable field name in Column repr

Clear the caplog in retried tests

Don't register any TypeInfo on oid 0

Someone may conceivably register info of an array only. Let's not
clobber INVALID_OID, I wouldn't know the side effects...

Don't copy the types map from context to recursive dumpers

It can be accessed from the object's transformer.

Use uppercase SQL throughout code and docs

I personally prefer lowercase, but uppercase is more familiar. There is
also a tiny advantage in greppability, in case someone tries to trace a
generated statement in the code.

The myth that using UPPERCASE the database will sense your urgency and
will run your queries faster has been dispelled.

Cache generated begin statement on the connection

Add hstore adapters

Respects transaction status of the connection used by TypeInfo.fetch

Also make sure that the method returns None instead of throwing an
exception and leaving the connection broken in case the object is not
found.

Merge branch 'transaction-control'

Implement the transaction control attributes

Add IsolationLevel and transaction control attributes on connection

Only add the documentation and the property: they don't work yet.

Handle timestamps which would overflow in UTC but not in the want timezone

Better display of block examples in docs

Fix server-side cursor close() with committed transactions.

Move withhold/scrollable as server-side cursor attributes

Add respective properties to read back the state.

hold renamed to withhold for server side cursors

Add cursor_factory and server_cursor_factory attributes

Remove format param from cursor constructor

Fix Range get_key/upgrade

The adapter doesn't need upgrading not when it knows its oid but when it
adapts a Range strict subclass. The difference emerges if a query
handles different types of ranges in composite types.

Problem found by random testing: https://github.com/psycopg/psycopg/runs/3104464032
Thank you, faker!

Display the Dumper oid in its repr

Add faker context manager to help found problematic values

Retry flaky tests

Make starting the test proxy idempotent

Helps with retrying tests.

Fix Windows package build

The package was built with a libpq 11, found along the path in the PHP
dir. And with the libiconv found in the Git directory. All very
worrying.

So, add to the PATH the Postgres bin directory and deal with the
delvewheel exception of libiconv (mentioned in
https://github.com/adang1345/delvewheel/issues/13).

Also fix confusion about where does this stuff run and where is the
server. There is no Docker image here, so we can start the server from
the workflow steps and access it from cibiuldwheel on localhost.

Drop outdated script to build wheel packages

Using cibuildwheel and the scripts in the `tools/build` directory now.

Add notes about making a release

Bump to next dev release

Bump to next version to build test packages

Test C extension on Windows and build binary packages

The built wheel package seems broken, but delocating it seems to fix it.

Use the PG_CONFIG env var to specify the pg_config location because
hacking the path is not straightforward with cibuildwheel and has
unwanted side effects with delvewheel.

Drop test skip for a long solved problem

Retry some flaky tests

Fix test retry pattern

Fix types registry shallow copy

Mark the template as dirty, so that if it's changed the registries that
were cloned for it will remain unchanged.

Add fixture to restore the state of the global adapters

Fix dumping arrays of different versions of network objects

Use a single dumper for both IPv4 and IPv6 so that the array sub_dumper
is not ambiguous.

At import -> at import time

Move "from psycopg2" docs page under basic

And tweak it a bit.

Drop a fixme related to a bug closed in furo docs style

I prefer our style though, so we are not reverting back to the template style.

Add link to GitHub Actions runner bug hack

Fix reference target to the psycopg module

It was stolen by the errors module.

Left align table contents in the docs

Consistent TOC expansion in docs second level pages

Adapt docs cleanup

Corrections to the types module docs

Add example of numeric-to-float loading

Add wheel package to dev dependencies

We get warnings when we build the C extension without it. Probably they
are harmless, but let's pretend we understand what it is for.

Add sphinx-autobuild to docs dependencies

It would probably be a dev dependency, but it would pull the whole
Sphinx in devs, which is not necessarily needed there.

Display two title levels in the main docs TOC

Drop repetition in adapt docs, and more cleanup around it

Fix tox docs build

Docs building dependencies updated

With the current documentation the image in advanced/adapt is not
displayed. Trying if upgrading fixes the issue because the furo theme
was upgraded but Sphinx didn't and they may be incompatible now.

Docs build dependencies moved to setup.py.

Adding more glue content to docs

Move copy docs to the basic section

Add docs for the psycopg module

Retry more flaky tests

Merge branch 'adapters-protocols'

proto modules renamed to abc

Improvements to the adaptation documentation

Add unit tests for register_loader/dumper types

Use the more idiomatic type name for the other tests.

Expose postgres.adapters from the psycopg package

Drop flake8 ignore on types/__init__ file

Drop .register() method from Dumper/Loader classes

Use the register_dumper/loader() method on the adapters, readily
available from the context. A bit of a violation of Demeter law, but
much more intuitive and simplifies the Dumper/Loader interface (the
methods were outside the protocol).

Add postgres module

The module exports PostgreSQL specific configurations: the mapping
oid -> types and the mapping from oid/types to dumpers/loaders.

Allow adapter protocols tests to run on Python 3.6

Add Loader protocol

Remove the cls attribute from the Dumper protocol

Where used, in recursive types, get_key() can be used instead.

Rename adapt.Format to PyFormat

Add Dumper protocol

The presence of this protocol allows to implement custom dumper that
don't inherit from psycopg ones and still be statically checked.

Don't chain exceptions on pool timeout

Cleanup of install docs

More terse import error of the requested implementation

Cleanup of metadata and readme presented on PyPI

Note in the first docs example that the module name is psycopg

Bump to version 3.0.dev0 to release testing packages

Add workflow to create sdist packages