Use the clear() method in PrepareManager.maintain()

Add handle() and validate() methods to PrepareManager

These essentially perform the same steps as maintain() but with only
query information first, and then once results become available.

Add a rotate() method to PrepareManager

Add a check_results() method to PrepareManager

Add a setdefault() method to PrepareManager

Add a should_discard() method to PrepareManager

Add a key() method to PrepareManager

Peg version of the docs theme package

Install the pool in the docs environment in editable mode

Add sphinx link to docs footer, drop page source link

Merge branch 'two-phase-commit'

Close connections in TPC tests to avoid warnings in tests

Add documentation for two-phase commit support

Add type annotations to two-phase commit tests

Move two-phase transaction fixture to a common place

Importing it across test cases requires too silly workarounds.

Also do without attrgetter.

Add two-phase support method to async connection

Add two-phase commit DBAPI Connection methods

Drop in dbapi tests for two-phase commit support

Start working on Psycopg 3.1

Bump to next release number

Merge branch 'fix-165'

Don't clobber exception if rollback fails on transaction exit

Just raise a warning, consistently with what happens to the connection.

Close #165.

Merge branch 'fix-158'

Make sure to close selectors after usage

Failing to do so leaks file descriptors and may lead to "Too many open
files" errors (experienced on macOS, using kqueue selector).

Close #158

docs: fetch libpq functions index from PostgreSQL 14 docs

Improve a few adaptation-related error messages

Gitignore the build directories, but not /tools/build/

Consolidate other local ignores into the main one, as all the ignores
are generic.

Guard delay_connection in tests for negative sleep argument

It happens if connection time was slow enough.

Use an empty string instead on None in the copy work queue

The test for copy end is just "if not item", so the empty string is
actually never used as a piece of data. This simplifies the type of the
queue.

Fix typo in comment

Add a minimal coverage configuration

We use pytest-cov, as it enables running coverage with pytest in a
single command.
We exclude 'if TYPE_CHECKING:' and ellipsis lines from report.

Merge pull request #120 from dlax/waiting

support RW ready in waiting functions

Possibly send a Ready.RW value to generators waiting on RW

In some generators, we might be interested in receiving both read-ready
and write-ready event at the same time.

Per previous commits, all wait*() functions support this.

This is covered by test_wait_ready(), which now maps Wait.RW to
Ready.RW.

Always stop monitoring fds in wait_{,conn_}async()

Handle RW-ready in wait(,_conn)_async()

Add an assertion in wait_selector() / wait_epoll()

Making sure the ready event matches what we're waiting on.

Fix wait_epoll() when the fd is read- and write-ready

We follow the implementation of EpollSelector.select(). The
test_wait_ready() introduced previously added now passes for
wait_epoll().

Add unit tests for wait*() functions

We check that when a generator waits for a Wait value, it gets a Ready
value that matches. The socket we wait on is read- and write-ready.

These tests hang on non-Linux platform in CI, perhaps because some
socket operations (e.g. fileno()) are not portable, so we only run them
on Linux.

As is, wait_epoll() fails this test because it assumes that readiness is
either read or write, not both.

Warm up database before running tests

Sometimes, in the test CI, the first connection may take a long time,
and if the first test is about connection timeout, it might fail.

https://github.com/psycopg/psycopg/runs/4206004327?check_suite_focus=true

Disable running CI tests on tag

At least I hope. According to GitHub Docs [1]:

> If you define only `tags` or only `branches`, the workflow won't run for
> events affecting the undefined Git ref.

[1]: https://docs.github.com/en/actions/learn-github-actions/workflow-syntax-for-github-actions#onpushpull_requestbranchestags

Fix sentence about binary packages not supporting Alpine Linux

Add missing classifiers for Python 3.10

Bump to next dev packages

Set packages version numbers for release

Add mention to the libpq upgrade ticket in out tracker

Close #149.

Merge branch 'upgrade-lipbq'

Mention libpq upgrade in news file

Upgrade libpq in Windows packages

Update alpine linux packages before building wheels

Upgrade libpq in macOS packages

strip_wheel: don't require to install the zip system package

Use the zipfile module command line.

strip_wheel: pass script parameters to the strip command

Initialize UTC in the timezones cache

Not having it might cause spurious errors in particular cases, we see it
failing sometimes in the CI on Windows (which lacks the timezone
database) on Python 3.6 with a ridiculous:

    unknown PostgreSQL timezone: 'UTC'; will use UTC

The similar cache on the Python side is primed the same way.

Dispose more carefully of connections and threads in concurrency tests

I have seen some segfault on Windows sometimes, probably with the
test_concurrency thread stomping over the memory of the process forked
in test_multiprocess_close.

Async tests refactored the same way, although they don't exhibit the
same problem.

Fix CI tests

I made this change earlier but committed the wrong branch... Sowwy.

Drop unneeded 'cursor()' in docs

Configure pytest color output in test using env var

Less repetitions.

Configure pytest warning control in pyproject.toml

This reduces duplication and makes the configuration available when
testing outside CI.

Specify older libpq in test matrix now that 14 is the default.

Fix Python version in Windows test

Add news entry about _compat dependency removed.

Add psycopg_pool._compat module.

Using psycopg._compat creates an unwanted coupling between the modules.
As it is now psycopg_pool 3.0.1 is not compatible with psycopg < 3.0.3
because of the dependency on Deque added in 1a5b09b2.

Less strict gitignore of the 'build' dir

It was hiding changes in the `tools/build` directory...

Bump pool version number to next dev release

Add news entry about zoneinfo segfault fix

Merge branch 'stricter-tests'

Docs typo fixed

Solve race conditions in test

Silence test warnings on Python 3.6

Fix segfault using timezones on Python 3.6 in -Werror mode

Also fix a couple of attribute errors in less used code paths (in the
branches reporting errors when using unsupported datestyles).

Related: https://github.com/pganssle/zoneinfo/issues/109

Close all the resources during tests

This allows to run the test suite with -Werror.

Raise error on warnings in tests

Assume Python 3.10 available in the test runners

Drop string-bytes comparisons

They were mostly internal ones, coming from dicts containing strings and
bytes as keys.

Close #147

Enable error on str-bytes comparison in pytest

See #147

Shorter names in the build

This way we should be able to more of the grid parameters in the left
column of the Github build run page.

Bump to next dev release

Update dep on pytest-asyncio

Works fine with 0.16.0

See #143

Bump version numbers to release psycopg 3.0.3 and pool 3.0.1

Fix duplicate sentence in connection pool docs

Merge branch 'fix-144'

Add release notes file for the psycopg_pool package

Don't leave connections in transaction after pool.check()

Close #144.

Merge branch 'mypy-tests/all'

Let mypy check all tests/*

Per previous commits, the whole test suite should be clean.

Install test dependencies in 'mypy' tox env

We need this at least for tenacity.

Declare 'elapsed' value before usage in async connection tests

Resolves mypy error:
  error: No binding for nonlocal "elapsed" found  [misc]

Declare tx_params using TypeDict values in connection tests

This resolves a bunch of mypy errors because the second-level values of
tx_params are of heterogeneous types.

Ignore mypy 'attr-defined' error about asyncio.ProactorEventLoop in tests

Ignore mypy 'index' errors about cursor.fetchone() in connection tests

Add type variable to *Cursor in connection tests

Adjust types in test_connection*::test_row_factory()

We avoid using the same variable name for different types. At the end,
there seems to be something wrong, thus add a TODO for later.

Ignore mypy 'comparison-overlap' error about row_factory in tests

Catch explicit exception type in test_connect_badargs()

Work around the type of pytest.raises() which appears too strict.

Only declare type of 'the_conninfo' in test_connect_args()

Inform mypy that we're not passing a None to conninfo_to_dict().

Ignore mypy 'comparison-overlap' in connection tests

Let mypy ignore uvloop imports, missing types

Allow mypy implicit re-export for tenacity

Tenacity does not explicitly re-export names. Ignoring this fixes a
couple of mypy warning in tests/conftests.py.

Make test_concurrency*.py mypy-clean

Make test_copy*.py mypy-clean