Reduce the work done on the cursor by executemany

Certain functions were executed once per query (e.g. _make_row_maker(),
_tx.set_pgresult()) but we can run them only once.

Finalise version 3.0.6 for release

Don't run Mypy tests on Windows/macOS

These tests are kinda slow and these platforms are the slowest to run.
Testing Mypy on Linux covers other platforms too.

A sample GitHub tests run (with no other concurrent job) went down from
22m to 18m.

Merge branch 'fix-177'

Detect out-of-order transactions exit when they have the same name too.

Detect out-of-order transactions exit when they have the same name too

Close #177

Don't try to execute transaction finalization with the connection closed

Refactor Transaction queries generation into internal methods

Refactor Transaction adding an internal push method

Nice and symmetric w.r.t. the pop method recently introduced.

Add tests to verify out-of-order detections without threads

Merge branch 'transaction-concurrency'

Raise ProgrammingError on out-of-order exit from transactions

Previously it would have failed an assert.

Further back in time, the condition was checked and reported as
ProgrammingError already. The check was dropped when
`conn.transaction()` started to return an entered transaction, so the
possibility of calling enter/exit manually was taken out of the public
API. However, we didn't consider the possibility of concurrent
threads operating on transaction independently.

Also fix the Transaction representation, which wouldn't have reported
`(terminated)` exiting on rollback, but only on commit.

Close #176.

Make the test to detect out-of-order transaction exiting reliable

Test transactions with concurrence [skip ci]

Fix docs typo

Improve Dumper, Loader documentation

Reword the types package description with more links to relevant docs

Fix duplicate docs for Cursor.description

Add ConnStatus.CHECK_STANDBY enum value

Added in PostgreSQL 14, only visible during connection, if at all.

Reword PyFormat docs

Fix a couple of typos in pool docs

Merge pull request #167 from dlax/trace

Add bindings for PQ tracing functions

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.