Mention addition of trace function in news file

Report that trace is *currently* only supported on linux in errors

We will add support for other platforms, if others care.

Add a --pq-tracefile pytest option

When specified, we'd enable tracing of the client/server communication
to a file. The file is opened for the whole test session and we set a
title section before each test run.

Add bindings for PQ tracing functions

Since we cannot pass a file descriptor as a FILE value, as expected by
PQtrace(), PGconn.trace() method accepts a 'fileno: int' value. This is
then used to build an stdio's FILE value through fdopen(). The latter
also needs a binding in ctypes. This only works on Linux platform.

In _pq_ctypes.pyi, fdopen() and PQtrace() are not autogenerated because
of the needed '# type: ignore' (similar to existing ones).

PQsetTraceFlags() is new from libpq 14, so we declare it conditionally.

Flag the bugfix version unreleased in the docs news

Don't raise an exception using cur.description with closed connection

Close #172.

Raise OperationalError on Connection.cursor() if closed

Drop unneeded sort() in test

Fix whitespace excess

Reported as error by new black version.

Don't raise exceptions on ServerError.close() if the connection is closed

Close #173.

Drop a few unused imports in pgconn.pyx

Add _PQencryptPasswordConn() in _pq_ctypes.pyi

Running the generation script produces this diff.

test: run tests against PostgreSQL 14 on macOS

brew gives an error installing v. 13.

Merge branch 'preparing-refactor'

Remove prepared statement maintenance command out of the normal loop

Accumulate the maintenance commands in the state of the prepared
processor manager and decide when to process them.

Split the internal state of prepared statements into names and counts

Refactor away internal prepared statements manager function

Drop PrepareManger.maintain()

reimplement PrepareManager.maintain() calling other public methods

This makes clearer that, in pipeline mode, we call them in two different
moments, whereas in non-pipeline we call them in a single place.

Rename prepare manager methods

Underscore the methods that are only called internally.

Change some of the public names. However this is just temporary, to
reason about who calls what.

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