test: fix test failing to connect if env vars are cleaned

Add `dsn_env` fixture returning the `dsn` merged with the values in the
PG* env vars. This way the env can be cleaned but a working connection
string is still available.

fix: flush PG environment variables in test_connect{,_args}

These tests were previously affected by environment variables, that can
be used to configure a postgresql instance.

Closes: #681

chore(ci): use existing macos11 packages in macOS arm build

chore: bump psycopg package version to 3.1.13

fix: plug memory leak receiving notifications in python libpq wrapper

Close #679.

Merge branch 'fix-multiple-hosts-3.1' into maint-3.1

chore: drop conninfo.resolve_hostaddr_async

The function is no more used internally and only exposed from the _dns
module with a warning. Its implementation is now an application of a few
internal functions exposed internally by the conninfo module. Move the
whole implementation into _dns.

fix: add support for the 'load_balance_hosts' connection parameter

test: test conninfo attempts functions and multiple host support in connection

feat: explicitly iterate on multiple hosts on connections

The libpq async connection path doesn't iterate on the attempts, so we
need to do it ourselves.

refactor: introduce support function to split connection attempts

Refactor the `resolve_hostaddr_async()` function to make use of such
facilities.

refactor: move setting autocommit on connection out of _connect_gen

chore: bump min Python version tested with SQLAlchemy to 3.8

chore: refresh 3rd party tests

- upgrade Python to 3.12
- test stable version of SQLAlchemy 2
- add missing SQLAlchemy test dependency

Testing Django with Python 3.12 not enabled yet as it requires pylibmc wheel
packages for Python 3.12 (https://github.com/lericson/pylibmc/issues/288).

chore: bump psycopg_pool package version to 3.1.10.dev1

chore: bump psycopg_pool package version to 3.1.9

fix(bump_version): fix bumping minor version with dev releases

chore(macos): build images with more recent Python versions

Merge branch 'fix-667-3.1' into maint-3.1

fix: retry automatically syscall in wait_c if it fails with EINTR

Fix #667

test: add test to generate an EINTR in wait_c

Mark test_identify_closure as timing-sensitive

```
____________________________ test_identify_closure _____________________________

conn_cls = <class 'psycopg.Connection'>, dsn = 'host=127.0.0.1 user=psycopg'

    @pytest.mark.crdb_skip("pg_terminate_backend")
    @pytest.mark.slow
    def test_identify_closure(conn_cls, dsn):
        def closer():
            time.sleep(0.2)
            conn2.execute("select pg_terminate_backend(%s)", [conn.pgconn.backend_pid])

        conn = conn_cls.connect(dsn)
        conn2 = conn_cls.connect(dsn)
        try:
            t = threading.Thread(target=closer)
            t.start()
            t0 = time.time()
            try:
                with pytest.raises(psycopg.OperationalError):
                    conn.execute("select pg_sleep(1.0)")
                t1 = time.time()
>               assert 0.2 < t1 - t0 < 0.4
E               assert 0.2 < (1697715164.8614173 - 1697715164.6617775)

tests/test_concurrency.py:231: AssertionError
```

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

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

style(pool): more explicit error message for pool open with no loop

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.

Merge branch 'fix-652' into maint-3.1

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

fix: raise DataError dumping a time with ambiguous timezone

Close #652

Merge branch 'cp312-build' into maint-3.1

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

ci: build Python 3.12 packages

chore: fix 'adapers' typo

style: avoid a chained traceback on dns parsing error

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.13.dev1

chore: bump psycopg package version to 3.1.12

Merge branch 'fix-608' into maint-3.1

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

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

chore(crdb): test 23.1 in CI

Merge branch 'fix-647' into maint-3.1

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

chore: bump psycopg_pool package version to 3.1.9.dev1

chore: bump psycopg package version to 3.1.12.dev1

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

chore: upgrade libpq, OpenSSL versions

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.

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

style: move private functions closer to the classes where they are used

For better alignment with the master branch.

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>.

Revert "chore(binary): bump depending libraries"

This reverts commit d424be88f63ee0d56088bcbc85904cdcc4fc48b8.

The commit only bumped the defaults in the build script, but actually
the proper version is in the workflow file. A libpq version fixing #528
was already released with psycopg-binary 3.1.10.

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

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' into maint-3.1

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' into maint-3.1

docs: add news entry about bug #630 fixed

* fix integer overflow for oids > 2^31

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.

chore: bump psycopg package version to 3.1.11.dev1

chore: bump psycopg package version to 3.1.10

chore: upgrade cibuildwheel

chore: bump libpq, openssl used in binary packages

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 branch 'pipeline-nextset-warning' into maint-3.1

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.

docs: fix release version of json bytes dump support

It is to be released in 3.1.10, not already released in 3.1.9... See #568

Merge branch 'py312-3.1' into maint-3.1

docs: mention Python 3.12 support in news file

ci: bump Python 3.12 test version to beta 4

test: mark tests as failing to monitoring strange behaviour with Python 3.12

With Python 3.12a7 and Cython-3.0.0b3, these two tests fails. It seems
that when an exception is involved the __del__ method is not called.

ci: set up test grid to test Python 3.12

chore: declare Python 3.12 supported in classifiers

chore: upgrade Cython to stable 3.0.0

fix: fix "can't adapt" error message on Python 3.11

It appeared like "using placeholder '%PyFormat.TEXT'" because of the
change in the Enum display already fixed elsewhere.

Spotted in the conversation in #611.

Also fix unneeded nested exception in the Python version of the code.

fix: fix resetting read_only/deferrable to default using None

Merge branch 'fix-591-3.1' into maint-3.1

fix: fix possible errors calling __repr__ from __del__.

The errors get ignored but print a warning on program exit and eclipse a
genuine warning.

The error is caused by the `pq.misc` module getting gc'd on interpreter
shutdown before `connection_summary()` is called. The solution is to
import `connection_summary` in the module namespace, which is similar to
the solution that proved working for #198. It is less robust than the
solution used by the Python devs to import the function in the method
via an argument default, but it should work adequately (as nobody
complained about #198 anymore).

In #591 discussion, I proposed that connection_summary is too complex to
be considered safe to call on __del__. Actually, looking at it, it seems
innocent enough, as it only calls objects methods, no functions from
module namespaces. As a consequence we assume that this commit fixes the
issue. As I can't reproduce it, will ask the OP if this is the case.

Close #591.