chore(pool): add pyproject.toml

ci: configure the database to run two-phase-commit tests

We can't use the Github Actions PostgreSQL service because it doesn't
seem possible to configure the server for stored transactions:

- the service yaml definition doesn't take args to pass to run
- we can't overwrite the entry point with a script of ours because the
  service starts before actions/checkout
- the postgres image doesn't allow to pass extra parameters to the
  server via an env var

test: fix int mixin enum in test

perf: micro-optimize AdaptersMap.get_dumper

Minimal amount of opcodes in case of fast-path (there is an adapter
precisely for the class queried).

ci: separate source and binary package workflows

chore: bump psycopg_pool package version to 3.1.6.dev1

chore: bump psycopg package version to 3.1.8.dev1

test: mark another couple of tests flakey to avoid delaying releases

chore: bump psycopg_pool package version to 3.1.5

chore: bump psycopg package version to 3.1.7

feat(bump_version): create release tags too

feat(bump_version): update history file too

Merge branch 'fix-464'

fix: consider cursor description results in row factories

Fix #464

Merge branch 'detox'

test: drop --allow-fail and --no-collect-ok options

They were needed to deal with problem caused by tox. Not needed anymore.

ci: enable subprocess-based tests in ci

test: skip test on windows, C implementation, in ci

No idea why ctypes doesn't work, and I really don't care.

ci: drop tox from tests

Merge branch 'fix-438'

fix(pool): make sure that check() fills an empty pool

Close #438.

Merge branch 'test-crdb-v22.2'

test(crdb): re-introduce a mix of Python and libpq versions

Run tests against CockroachDB v22.2

v22.2 was released recently, so we can test it. This upgrade revealed a
regression in CRDB that we must workaround
(https://github.com/cockroachdb/cockroach/issues/93739).

This also removes testing for v21.2, since it is no longer supported.

ops: add script to bump package version

test: skip a flakey test on release

For 3.1.6 release, three package jobs failed on this test. One of them,
a ppc manylinux, took more than 30 minutes to rerun. Not pleasurable.

chore: bump psycopg package version to 3.1.7.dev1

chore: bump version number for 3.1.6 release

Merge branch 'fix-460'

fix(copy): don't create a row maker on copy

A COPY_OUT result has columns, but no names for the columns. This case
must be handled in cur.description (see #235) but we don't need to
handle it in copy. If we did handle it in copy, we would need a column
name fallback, which we forgot to handle, hence the problem in #460.

Close #460.

chore(binary): upgrade packaged libraries to libpq 15.1, openssl 1.1.1s

chore: bump to dev version 3.1.6.dev0

ci: run tests on Python 3.11 on macOS

chore: bump version number for 3.1.5 release

perf(rows): reduce row_factories overhead

Drop the call to cur.description, which is very heavy. Use the low-level
PGresult to get the fields names.

Close #457.

perf: drop call to pgconn_encoding per query

Cursor._encoding converted to property. It is only used in error
messages and infrequent operations.

Use uniformly the fallback value of utf-8 in *_encoding() functions,
especially when the connection is closed.

test: fix resource leaking in tests

It results in spurious warnings on ``gc_collect()`` in some innocent test
downstream::

    ResourceWarning: unclosed <socket.socket fd=14,
    family=AddressFamily.AF_UNIX, type=SocketKind.SOCK_STREAM, proto=0>

test: ignore error looking for leaks

The leaks counter frequently reports a leak between run 1 and 2 of the
tests. It turns out to be a Decimal Context whose items() method reports
no content. So the problem is related to Python, not psycopg, and it is
not an unbound leak.

Can't reproduce it in CI, but it happens on my laptop, since switching
to Ubuntu 22.04 with Python 3.10.

fix: don't re-export TypeAlias from _compat module

Pyright special-cases that type and requires to import it from typing or
typing_extensions only (see https://github.com/microsoft/pyright/issues/4197).

Drop conditional dependency on typing_extension and always import
TypeAlias from there.

Fix #439.

docs: fix ticket number in news file

Merge branch 'wait-select'

docs: report select speedup in news file

Close #411.

perf(c): add fast-call Cython function to PQflush wrapper

perf(c): small optimization tweaks to wait_c

test: skip high fd number test on Windows

Windows is pretty simple in regards of the wait function, because it only
implement select, and it doesn't have the same limit of the Unix select.

However this test sometimes fails in weird ways: on the pgconn.socket >
1024 assert, for instance. So, let's just skip it.

test: allow choosing a wait function using the PSYCOPG_WAIT_FUNC env var

We won't make this public yet, possibly we never will (I think we are
the people responsible for this choice), but it might be useful for
testing.

perf(c): use poll() instead of select() for waiting, where available

fix(c): guard select() from high number file descriptors

The Python `select.select()` wrapper raises ValueError. Without a guard,
the C `wait_select()` segfaults. The C way to say you have been naughty.

On Windows this seems not only not needed, but it actually stops from creating
any connection at all.

fix(c): allow wait_select() to be interrupted by signals

fix(c): fix import on Windows

perf(c): add C version of select waiting function

'Wait' and 'Ready' enums moved into the '_enums' module to avoid a
circular import.

perf: use wait_select() as even if kqueue is the default

There is a bit less overhead using this simpler function than using
wait_selector.

test: add test on wait_select

Refactor tests to make a better use of pytest parametrization and skip
conditions.

perf: use wait_select on Windows

On windows, the default selector strategy is select. As a consequence
using the higher level selector object comes with a performance penalty.

feat: add wait_select() function

A few tests show that using select() from Python has a lower overhead.
See #414.

Use this function wherever defined and epoll() is the default select
strategy instead. This is mostly a draft to figure out where this
strategy can be used with success.

test: add simple test to compare performances in refactoring

This test is inspired to the problem open in #411, and is pretty much a
simple operation in a tight loop. It is used, at the moment, to compare
different ways to test I/O completion strategies with simple and fast
queries under no concurrency.

chore: declare Copy.read to return a buffer object

We still return memoryview, but leave the possibility open to return
something different, such as bytes.

fix: add C Float4 dumper

It would be used when looked up by oid. At the moment there is only a
Python version for it.

lint(c): avoid types warning building on Windows

Merge branch 'array-speedup'

docs: add a note about further optimizing text array loading

perf(c/array): cache the scratch area in the dumper

perf(c/array): cache the element loader in the array loader

docs: report array speedup in the news

perf(c/array): add C implementation of array loader

With this change we get to load an array without the transformer calling
any Python code (if the element loader is a CLoader as well).

We don't need to subclass the binary loader anymore because all the
required info is now taken from the loaded data. As a consequence, we
don't need a BaseArrayLoader anymore.

perf(c/array): reuse buffer to unescape array tokens

Save a malloc and setting up an exception per element, replaced by
realloc when needed and a single exception per array.

fix(c/array): null-terminate strings in text array loading

perf(c): optimise access to C item loaders in array loading

perf(c/array): build binary array recursively instead of rearranging them

perf(c/array): optimize reassembling multidimensional arrays as nested lists

refactor(c/array): types hygiene around endianness conversions

fix: get element oid from the array itself in binary format

Getting it from the type was causing problems in CRDB because they seem
to have a different interpretation of what Int2 and Int4 are. Refactor
the binary parser to take a transformer, instead of a loader function,
in order to look up the loader from the oid parsed from the array.

Also refactor the text array parser to take the whole loader instead of
the load function only, which will be useful in order to optimize the
use of C loaders.

perf: add C implementation of array load

This implementation can be still improved: we always call the Python
loader to decode the single elements; we can try and call the C loader
if available.

perf(array): introduce mockup of optimized array loading functions

fix: add prod() implementation for Python 3.7

perf(array) faster algorithm to load nested binary arrays

Avoid using generators in the algorithm. This also makes the function
easier to port to C.

refactor(array): make load function static

This will allow replacing them with a fast version as with the helper
functions in the copy module.

Merge branch 'fix-452'

fix: add lookup of dumpers by varchar, name oid

Fix #452

test: add test to verify missing oid lookups in string formats

docs: drop tox from readme

I don't really use in for development, so it's better not suggesting it.

ci: force the use of tox 3

Work around https://github.com/tox-dev/tox/issues/2619

ci: fix tests failing because of missing repository public key

Fix the error appearing in CI reporting

    The following signatures couldn't be verified because the public key
    is not available: NO_PUBKEY 7FCC7D46ACCC4CF8

on the jobs using libpq: latest.

fix: return rownumber=None if the result has no row to fetch

Close #437.

chore: bump mypy to 0.990

chore: fix version number, accidentally bumped back

chore(pool): bump to next dev version number

chore; bump pool version number for release

Merge branch 'fix-219'

docs(pool): add entry about issue #219 resolved

fix(pool): make sure to throw a RuntimeError opening async pool without a loop

The error would be thrown anyway downstream, when tasks are created, but
other spurious warning might be raised too because certain tasks are not
awaited.

fix(pool): create asyncio objects on open rather than on init

If created on init, they get attached to the wrong loop and fail to
work.

Close #219

perf(c): take more care about the GIL around potentially blocking functions

refactor: move common notifies processing code into a common function

fix(c): drop duplicate PQconsumeInput call

Also add a couple of C types in the function for better C code.

fix: use a correct recursive definition for DumperKey

Already supported in current Mypy: https://github.com/python/mypy/issues/731.

The definition of DumperKey was wrong anyway, in a way causing mypy to
crash: see https://github.com/python/mypy/issues/14000.

lint: fix type hints with disabled bytearray/memoryview/bytes equivalience

This changeset makes the code compatible with the current Mypy 0.981,
but passes most of the checks that Mypy 0.990 enforces if the byte
strings equivalence is disabled.

fix: define Escaping method as returning bytes

This change is backward compatible because bytes has a superset of the
memoryview interface and, in Python, to make pretty much any use of it,
it must be converted to bytes beforehand.

Close #422.

fix: fix check for empty notice handlers list

Issue reported by Mypy 0.990. Thank you!

docs: use consistenty `!this` to represent parameters and non-linked code

Don't use *this*, which is more of a math use but it disagrees with the
style rendered on the docs, and don't use ``this``, left to literals.