refactor(pool): add psycopg_pool.abc module

chore: make ast-comments an ordinary dev dependency

ci: pin ast-comments to work around bug, document other bug as submitted

refactor(pool): light refactor to align async and sync pool

refactor(tests): generate null pool tests from async counterpart

refactor(tests): generate most pool tests using parametric fixture

refactor(tests): rename cursor tests to keep them together

Also rename test_default_cursor to just test_cursor as we renamed the
common tests in the previous commit.

refactor(tests): rename test_cursor to test_cursor_common

refactor(tests): generate test_pool from async counterpart

refactor(tests): generate test_sched from async counterpart

refactor(pool): generate Scheduler from AsyncScheduler

refactor: generate connection.py from connection_async

refactor(async_to_sync): finally solved the Tuple mystery

The problem came from names shadowing in the ast_comment module. To be
reported upstream.

refactor(connection): harmless manipulation to minimize async conversion diff

docs: copy connection docstrings to async class

perf(waiting): drop unneeded wait_for in wait_conn_async if no timeout is set

feat(connection): add set_autocommit() and similar methods

refactor: move BaseConnetion in its own module

This commit is brought you by: flight delayed 6 hours for technical failure.

refactor: generate cursor.py from cursor_async

docs: add docstrings from sync cursor to async

refactor: move the BaseCursor class to its own module

ci: check for inconsistencies between sync and async code

feat: add --check mode to sync-to-async script

It will be useful to set up a pipeline to check for inconsistencies.

refactor(tests): generate tpc, transaction sync tests from async

refactor(tests): make transaction sync/async tests more uniform

refactor(tests): generate sync prepared statements tests from async side

refactor(tests): auto-generate sync version of cursor subclasses

refactor(tests): auto-generate test_copy from async counterpart

refactor(tests): make test_copy and async counterpart more similar

refactor(tests): auto-generate test_client_cursor from async counterpart

refactor(tests): generate test_pipeline from async counterpart

fix(async-to-sync): fold long strings as multiline

refactor(tests): auto-generate test_connection from async

refactor(tests): make sync and async connection tests more similar

test: fix use of aclosing in Python < 3.10

refactor(tests): auto-generate the test_cursor module from async_test_cursor

Use a script to translate an async module to sync. The module is to be
extended to cover the entire test suite and then possibly the rest of
the code.

refactor(tests): tweak test_cursor to make it more similar to the async version

docs: update requirements specifiers link

docs: adjust list of supported systems.

- Mention Solaris/BSD as not officially supported.
- Drop non-GitHub macOS reference: we are now distributing Apple M1
  packages too, so that's a lie.

docs: making fun of psycopg3

For small values of fun.

docs: link together readme files on PyPI and add reference to psycopg2

See https://github.com/psycopg/psycopg2/issues/1632

docs: clean up details and errors in type annotations, more pages

chore: drop 'set -x' (commented and not) from scripts

docs(pool): simpler, less detailed, more opinionated pool docs page

Show a very basic usage example, then give a more detailed connection
life cycle illustration. Push lower and keep shorter the alternative
creation methods.

test: mark array leak test slow

It takes 300ms, but it's still a blip when other tests run.

Add notes in the tests readme about repeating finding slow tests.

refactor(pool): don't use a no-op function as reconnect callback

Just check for None.

style(pool): don't report too many decimals in timeout error message

fix(pool): trade off usage timing precision for robustness

It is unlikely that the statements we shuffled around will fail;
however, let's do the right thing and make sure that, if they do, the
getconn/putconn pair remains matched.

docs(pool): fix changelog entry

Attributing Generic pool feature entry to 3.2.0, not to 3.1.9.

Merge branch 'fix-652'

test: verify that time objects with failing utcoffset() are handled correctly

fix: raise DataError dumping a time with ambiguous timezone

Close #652

chore: drop Python 3.7 support

Also drop from the test grid PostgreSQL 10, now unsupported.

ci: add PostgreSQL 16 to the test grid

test: test Python 3.12 on all platform with final image

ci: add Python 3.12 packages build

chore: fix 'adapers' typo

style: avoid a chained traceback on dns parsing error

docs: fix typo

Merge branch 'generic-connection-pool'

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'