docs: add docs about generic pool

feat(pool): make pool generic on connection type

chore: add typing.assert_type() to the _compat module

This requires typing_extensions >= 4.2.

fix: use Self type for connection pool in __*enter__()

This makes inheritance, e.g. for *NullConnectionPool, work correctly:

    with psycopg_pool.NullConnectionPool() as p:
        pass
    reveal_type(p)
    # Revealed type is "psycopg_pool.null_pool.NullConnectionPool"

chore: bump psycopg package version to 3.1.12

Merge branch 'fix-608'

fix: use poll() instead of epoll() for waiting

epoll() hangs when the fd it listens to is closed. poll() doesn't have
this problem (as a consequence, hanging only happened in the Python
code, as wait_c is poll-based).

fix: don't hang forever if async connection is closed while querying

Fix #608

fix: don't raise spurious errors on cancel if the connection is closed

chore(crdb): test 23.1 in CI

Merge branch 'fix-647'

fix: cache all dynamically generated adapter types

These are not currently a leak in cPython, but I don't think it's
guaranteed anywhere, and it might well not be the case in other Python
implementations. So, as a matter of hygiene, make sure that calling
register_*() in a loop doesn't create an unbound number of new types.

fix: cache dynamic adapters created in register_array()

If the base class is a C extension, the subclasses cannot be GC'd. This
results in a leak if register_array() is called in a loop.

Close #647

ci(scaleway_m1): add list command and jq pretty output

chore: bump psycopg_pool package version to 3.1.8

chore: bump psycopg package version to 3.1.11

docs: Document what to do when a new major version of Postgres is released

ci: provision a M1 build server automatically, if needed

fix(bump_version): handle tagging without bumping version

ci: run 3rd party integration tests on commit on maint-3.1 branch

chore: update cibuildwheel version

chore: upgrade libpq, OpenSSL versions

docs: refresh stale release information

perf(windows): don't use wait_c.

The function was reported to use excessive CPU. Need to investigate,
however, for the moment, suspend its usage on Windows.

See #645.

docs: add docs about connection pool logging

fix(c): fix loading of intervals with days and months or years

Close #643.

ci: fix building Python 3.7 extension on windows using delvewheel 1.5.1

See https://github.com/adang1345/delvewheel/issues/39

chore: constrain importlib metadata to the version supporting Python 3.7

refactor: convert back query2pg from static method to regular function

On Python < 3.10, a static method doesn't seem callable, at least during
class building, so applying lru_cache on it fails.

fix: avoid caching the parsing of large queries

These queries are typically generated by ORMs and have poor
cacheability, but can result in a lot of memory being used.

Close #628.

See also <https://github.com/sqlalchemy/sqlalchemy/discussions/10270>.

chore(binary): bump depending libraries

Bump to libpq 15.4, OpenSSL 1.1.1v, OpenLDAP 2.6.6.

Particularly important is the libpq bump because the library, since
15.2, allows group access to the SSL certificate. See
https://github.com/psycopg/psycopg/discussions/528

docs: add porting tips for cursor subclasses

refactor(bump_version): do without parse_version function

Also allow for no change in the change log found (mostly for testing).

chore: avoid anyio >= 4 for the moment

The 'policy' parameter is not supported anymore, and finding the right
workaround is tricky, especially because it's only needed for Windows,
and because anyio 4 doesn't support Python 3.7, so we would need to
support both the versions.

When we will drop Python 3.7 support it will be easier move to anyio >= 4.

Merge branch 'fix-solaris'

docs: mention fix for solaris build

fix: support solaris and deriv

fix: add missing pipeline sync in async cursro scroll().

fix: add missing lock in async executemany with no pipeline

Merge branch 'fix-oid-overflow'

docs: add news entry about bug #630 fixed

* fix integer overflow for oids > 2^31

docs: allow square logos in the sponsors page

chore: add @webisoftcom logo sponsorship

Merge branch 'raw_query_support'

docs: improve docs about raw query cursors, add release note

tests: fix cursor tests to run on raw cursors too

fix: fix TypeInfo.fetch() with connections using RawCursor as factory

refactor: make is_param_sequence a type guard

Reduce the need of typing hints here and there, although, if it returns
false, it doesn't guarantee "the other half of the union".

Add raw query support with PostgreSQL native placeholders

This commit introduces support for raw queries with PostgreSQL's native
placeholders ($1, $2, etc.) in psycopg3. By setting the use_raw_query attribute
to True in a custom cursor class, users can enable the use of raw queries with
native placeholders.

The code demonstrates how to create a custom RawQueryCursor class that sets the
use_raw_query attribute to True. This custom cursor class can be set as the
cursor_factory when connecting to the database, allowing users to choose between
PostgreSQL's native placeholders or the standard %s placeholder in their queries.
The code also demonstrates how both styles of placeholders can coexist. Test
cases are included to verify the correct behavior of the new feature.

Merge branch 'tests-refactoring'

test(crdb): accept different exception on multi-query prepare attempt

test: unify server and client async cursor tests

Also clean up differences between sync and async cursor tests.

test: refactor common cursor tests using parametric fixture

Tests common to Cursor and BaseCursor now use the same code, with a
parametric connection fixture to run both them.

Tests specific to one of the class moved to a module of their own.

TODO: copy tests might do the same. Async cursors tests should be
refactored too.

fix: rename QueuedLibpqWriter object

It was mistakenly named Driver, not Writer.

fix: fix infinite loop and OOM in bad executemany

The bad condition is only reached using COPY into executemany in
pipeline mode and with prepared statements disabled. It should probably
never happen outside the unit test.

Merge branch 'numpy-types-support'

feat(crdb): add numpy support

fix(c): don't try to mutate Cython type

These types are now marked immutable. Use a module variable instead.

fix(copy): fix dumping by oid in text mode

It is less useful than in binary mode, but it was being pretty much
ignored.

fix(numpy): fix dumping numpy values by oid

refactor(numpy): get  OIDs from the _oid module

Also drop context optionality in adapters registration.

docs: add news entry and docs about numpy scalars support

feat: add C numpy dumpers

docs: improve comment about why we need to register builtin numerics last

refactor(c): add _IntOrSubclass dumper to the C dumpers too

test(numpy) avoid overflow testing with int16

test(numpy): drop test with deprecated alias

test(numpy): add dump tests with list of numpy values

test(numpy): allow more approximation comparing float16 values

    >>> numpy.float16("-0.00018227100372314453")
    -0.0001823

    >>> -0.0001823 == pytest.approx(-0.00018227100372314453, rel=1e-5)
    False

    >>> -0.0001823 == pytest.approx(-0.00018227100372314453, rel=1e-3)
    True

fix(numpy): fix dumpers registration order

If numpy dumpers are registered after numeric ones, then NPNumericBinaryDumper
is used instead of NumericBinaryDumper when looking up by oid. This
breaks dumping values with a decimal part.

test(numpy): consolidate numpy float tests

test(numpy): add random tests with numpy objects

test(numpy): consolidate all numpy int tests in a single parametrized one

test(faker): don't crash if a lazy-import dumper class is not available

feat(numpy): add longlong dumpers

refactor(numpy): reuse base or final classes from builtin numeric types

refactor(numpy): drop aliases for dumpers

Leave only one class per target PostgreSQL type and map the Python type
to the smallest type fitting the whole domain.

refactor(numpy): use builtin bool dumpers for numpy booleans too

test(numpy) fix tests with approximative comparisons

refactor(numpy): use existing numeric base classes

test(numpy): fix skipping tests if numpy module is not installed

feat: add numpy dumpers for int, float, bool types

Close #192.

chore: bump psycopg package version to 3.1.10

chore: upgrade cibuildwheel

chore: bump libpq, openssl used in binary packages

Merge branch 'pipeline-nextset-error'

fix: drop error using nextset() in pipeline mode

Now that the behaviour of pipeline is the same of non-pipeline, raising
an exception on nextset is a difference in behaviour we can probably
drop.

fix!: only keep results of last execute() by a cursor in pipeline mode

The assertion on fetchall() in 'test_execute_nextset_error' now passes.

Fixes #604.

fix: raise an error instead of a warning using nextset in pipeline mode

Note: the tests, intentionally, don't pass, because they expects
execute() results to clobber the previous ones rather than accumulating.
This behaviour is to be changed in a further commit.

See #604.

fix: raise a warning if nextset is used after execute in pipeline mode

So far have accumulated results, unlike in no-pipeline mode, where
results have been discarded. But this proved to be not reliable, so we
will forbid it in 3.2.

See #604

docs: drop example about using nextset() in pipeline mode

The feature is sort of accidental, not tested, and proved to be not
reliable, so we will remove it in 3.2.

See #604.

Mark two more tests as timing-sensitive

FAILED tests/pool/test_pool_async.py::test_reconnect[asyncio] - AssertionError: [0.11509847640991211, 0.2041318416595459, 0.40631914138793945]
FAILED tests/pool/test_pool.py::test_reconnect - ValueError: the proxy didn't start listening in time

Merge pull request #603 from JelteF/add-close-prepared

Add Close wrappers to PGconn

docs: add news entry about libp1 17 close functions support

test: add CI jobs to run libpq with PG master

test: add tests for close_prepared/portal for unsupported libpq

fix: fix pq close wrappers Python implementation

Co-authored-by: Denis Laxalde <denis@laxalde.org>

test: add tests for close pq wrappers

fix: add close wrappers to FinishedPGconn too