chore: add connection debugging log in the C extension too

chore: add debug logging at connection time

Only added to the Python implementation for the moment.

See #888

fix: guard from unexpected connection status on repr

chore: bump psycopg package version to 3.2.7

feat: implement binary hstore protocol

test(pool): verify the overriding of `close()` to act as `putconn()`

We would like to maintain this possibility on a best-effort basis. The
hack has been mentioned in #1046 and upstream in
https://github.com/sqlalchemy/sqlalchemy/discussions/12522 and is useful
to integrate psycopg pool with the SQLAlchemy NullPool.

test(crdb): add test reproducing failure with prepared create statement

See #1009

ci(crdb): pull stable crdb images from crdb docker repository

style: define a symbolic const for null values in array

chore: drop unneeded nonlocal declarations

Flagged by flake8 7.2

Merge branch 'walrusify-3.2' into maint-3.2

refactor: use assignment expressions in loops with assignment and break

refactor: use the assignment operator in assignments followed by an if

chore(deps): bump the actions group with 2 updates

Bumps the actions group with 2 updates: [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel) and [prefix-dev/setup-pixi](https://github.com/prefix-dev/setup-pixi).

Updates `pypa/cibuildwheel` from 2.22.0 to 2.23.2
- [Release notes](https://github.com/pypa/cibuildwheel/releases)
- [Changelog](https://github.com/pypa/cibuildwheel/blob/main/docs/changelog.md)
- [Commits](https://github.com/pypa/cibuildwheel/compare/v2.22.0...v2.23.2)

Updates `prefix-dev/setup-pixi` from 0.8.3 to 0.8.4
- [Release notes](https://github.com/prefix-dev/setup-pixi/releases)
- [Commits](https://github.com/prefix-dev/setup-pixi/compare/v0.8.3...v0.8.4)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-version: 2.23.2
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
- dependency-name: prefix-dev/setup-pixi
  dependency-version: 0.8.4
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>

docs: rename some news.rst section headers from python to psycopg

perf(composite): drop an if and a tuple() call

Merge branch 'shapely-srid' into maint-3.2

ci(shapely): test shapely with a more current Python version

test(shapely): better use of fixtures to drop test duplications

docs: mention shapely SRID support in news file

fix: manage shapely conditional imports explicitly

test(shapely): Handle missing SRID support

fix(shapely): maintain Shapely < 2 compatibility

chore: add types-shapely to dev dependencies

fix(shapely): add SRID support

chore: configure flake8 for imports after pytest's importorskip

ci: run bin package workflow on workflow file changed

fix: fix `status` annotation in `connection_summary`

Currently enum names are strings, but this is being changed to become
Literal. When this will happen, the type inferred will not be valid
anymore, as we mutate it and manipulate it as string in the function.

See https://github.com/python/mypy/pull/18797

chore: bump psycopg package version to 3.2.7.dev1

chore: bump psycopg package version to 3.2.6

Merge branch 'fix-target_session_attrs-prefer-standby' into maint-3.2

test: skip target_session_attrs with libpw < 14

Only one test fails with the currently "oldest" libpq, which is 10.2,
however the docs in libpq 13 are not explicit in which modes are
supported and, afaics, 'replica' shouldn't work either.

https://www.postgresql.org/docs/13/libpq-connect.html

fix: implement libpq semantic for target_session_attrs=prefer-standby

First attempt all the servers in standby mode, then fall back to any
mode.

Fix #1021.

fix win32 libpq missing error

chore: bump psycopg package version to 3.2.6.dev1

chore: bump psycopg package version to 3.2.5

chore: bump build libraries

Merge branch 'cython-uuid-3.2' into maint-3.2

docs: mention UUID speedup in release news

chore(c): remove C UUIDDumper and UUIDBinaryDumper

perf(uuid): speed up UUID creation using a writable subclass

Introduce an object memory-compatible with UUID, but writable. Try to
create this object in the fastest possible way: calling __new__ and
setting its attributes. Then replace the class with the standard UUID.

perf(c): use PyObject_CallFunctionObjArgs in UUIDBinaryLoader

perf(c): use PyObject_CallFunctionObjArgs in UUIDLoader

test(c): test UUID.__slots__

perf(c): Use hex_to_int_map in UUIDLoader

perf(c): lazy load UUID

perf(c): use UUID.__new__

perf(c): add Cython UUID dumper and loader

chore: bump psycopg package version to 3.2.5.dev1

chore: tweak linters output in pre-commit

style: apply isort on codebase

chore: add isort configuration

ci(crdb): enable crdb 25.1 tests

Test were failing because of the setting 'autocommit_before_ddl' now
defaulting to 'on'. After exchanging with CRDB developer, this seems the
correct behaviour for their database moving on.

ci: bump Python version in Django main test to 3.12

Python 3.11 is no longer supported in Django main version..

install libmemcached-dev to satisfy a Django dev dependency for a
package that doesn't provide a wheel distribution. Close #999.

Tests with both the oldest and the newest versions supported by Django.

ci: avoid segfault building binary packages caused by qemu bugs

Discussion at https://github.com/pypa/cibuildwheel/discussions/2256

style: adjust docstring after black 25.1.0 upgrade

docs: document why pre-commit language is set to 'local'

chore: typos fixed

docs(ci): add notes about libpq caching

ci(crdb): test with oldest supported Python release

ci(crdb): test with the master release

ci(crdb): bump CockroachDB versions in tests

chore: bump psycopg package version to 3.2.4

docs: mention the binary packages changes in news file

chore(binary): bump libpq to 17.2

Note: on vcpkg, v17 is not available yet. Furthermore it's not easy to
pin the version. See https://github.com/microsoft/vcpkg/discussions/25622

chore(binary): bump OpenSSL to 3.4.0

Merge branch 'build-libpq-macos-3.2' into maint-3.2

ci(binary): less verbose libpq build

ci(macos): drop Python 3.8 build on macOS arm64

We weren't distributing this combination anyway even when linking to
Homebrew libraries.

ci(macos): build libpq instead of using Homebrew libraries

This avoids problems with MACOSX_DEPLOYMENT_TARGET drifting in builders
(see #858).

Largely contributed by @bwoodsend in https://github.com/psycopg/psycopg2/pull/1755.

refactor: don't keep the notifiers backlog handler in the connection state

Just keep the queue in the state and special-case its handling in the
`_notify_handler` connection method instead of registering a standard handler.
Set the queue to None to signify that we are in the `notifies()` generator.

This way we don't need the awkward weak-self + class method to avoid a
reference loop and to dereference the connection weak reference another
time, as we just did in `_notify_handler()`. Setting the queue to None
also feels cleaner than adding/removing the handler.

Relates to #975.

Merge branch 'fix-clobbered-error-on-disconnect-3.2' into maint-3.2

test: soften disconnection tests on platforms knwon to behave differently

test: add test to verify that a server disconnection now raises AdminShutdown

Previously it was raising OperationalError, but this was just the result
of the issue reported in #988. Note that AdminShutdown is a subclass of
OperationalError, therefore this change is backward compatible.

fix(c): don't clobber an error from the server with a server disconnection

Instead of raising the exception here, return the result and let the
caller handle the exception. This might make code paths more uniform and
helps the C implementation, because we actually never call
`error_from_result()` in the Cython code.

fix: don't clobber an error from the server with a server disconnection

The server error is assumed to contain more information, as it is
returned as a result, whereas a communication error caused by a server
disconnection will only make available the error message.

Close #988 (but we need to fix the Cython side too).

test: add test to reproduce the wrong error on disconnect

We raise `OperationalError` instead of `IdleInTransactionSessionTimeout`.

See #988.

fix(debug): print exceptions eventually raised by libpq calls

Merge branch 'pre-commit-3.2' into maint-3.2

chore: fix problems reported by mypy 1.14.1

docs: document pre-commit usage

ci: enable 3rd party tests on maint-3.2 branch

lint: add typing annotations to pass pre-commit

Pre-commit seems to run mypy in parallel batches, each with about 20
files. In this mode, certain tests that pass when running mypy all in
once or file-by-file, fail.

In the current state, both running mypy without arguments or running it
in pre-commit seem to work.

ci: configure lint step to run pre-commit

ci: add pre-commit configuration

chore: ignore certain files from mypy linting

Something weird happens. Certain files pass mypy lint on their own, but
not in combination. This is mostly related to `psycopg/pq/pq_ctypes.py`
and `psycopg/pq/_pq_ctypes.py`. This problem seems largely related to
incomplete ctypes definitions.

chore: drop annotation on empty lists, now unneeded

If needed, it is considered wrong anyway, because it should be annotated
as class attribute.

Merge branch 'dont-lose-notifies' into maint-3.2

fix: always gather the notifications received

Starting to register them after the first call to notifies() is somewhat
weird. We also risk to lose notifications in a case such as:

    conn.execute("listen foo")
    conn.execute("listen bar")
    for n in conn.notifies():
        ...

fix: don't lose notifications between notifies() calls

This allows to stop periodically the generator to run some queries (for
example to LISTEN/UNLISTEN certain channels) and start the generator
again without fearing to lose notification in the window.

Cloes #962.

ci: move Python packages used for test into before-build script

ci(windows): use bash as default shell

Make packages-bin and tests workflow consistent.

chore(deps): bump pypa/cibuildwheel in the actions group

Bumps the actions group with 1 update: [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel).

Updates `pypa/cibuildwheel` from 2.21.3 to 2.22.0
- [Release notes](https://github.com/pypa/cibuildwheel/releases)
- [Changelog](https://github.com/pypa/cibuildwheel/blob/main/docs/changelog.md)
- [Commits](https://github.com/pypa/cibuildwheel/compare/v2.21.3...v2.22.0)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <support@github.com>

Merge pull request #966 from trim21/try-vcpkg

Use vcpkg to install libpq on windows

refactor: rewrite the pg_config stub in a more idiomatic way

ci: use vcpkg to install libpq on windows

test(windows): verify that the libpq used is what expected

fix: call the notifies callback while the notifies generator is used

Close #972

ci: bump runner to macOS 13

macOS 12 runners are now deprecated.

chore: bump mypy version to 1.14