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

Merge branch 'cibuildwheel'

Disable building Windows packages.

Install Postgres in the image to build Windows packages

Build Windows binary packages

Build MacOS binary packages

Make the script to build the binary package portable

Build psycopg-binary package for Linux

Test all the Python versions on MacOS and Windows

Merge branch 'windows'

Don't use the Cython IF construct

This produces independent .c files which can be included in the sdist
and be compiled on every supported platform.

Drop compile warinings on MSVC

Disable testing the C exception for Windows

Added libpq.lib to the path to run tests, but it didn't help.

I can't work around the import problem. Maybe delocating the package
would fix it? However, will ask for help for it.

Work around getpid on Windows

Add ws2_32 lib dependency on Windows

Pass the correct libdir to the window builder

"pg_config --libdir" returns "C:/STRAWB~1/c/lib"

Reported in https://github.com/actions/runner/issues/1178

Skip timing tests on windows

They fail less often than Mac OS, but they are still unreliable.

Add libpq dir to link options

Skip tests requiring an IANA db on Windows

Fix libpq name in windows linking

Work around _timezone name clash on windows

https://bugs.python.org/issue24643

Skip proxy tests on windows

It doesn't come up. zfg.

Fix inclusion of sys/param.h on Windows compiler

The header is probably available on Cygwin but not on MSVC.

Skip asyncio tests on windows

Add windows compatibility to endian functions

Run tests on windows

Refactor test workflow to avoid repetitions

Also test a sample Python implementation on MacOS.

Merge branch 'macos'

Skip proxy-based tests on MacOS tests

The proxy doesn't start in time 2s seem plenty.

Skip timing-based tests on GitHub Actions MacOS runners

Give a gc hit before running gc tests

Sometimes these tests fail because there is garbage before.

Run CI tests on MacOS too

Don't assume that the user "postgres" always exists in tests

Add compatibility with Mac OS