feat: implement binary hstore protocol

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'

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: improve basic usage example

Be consistent with return/print, make the second print actually print
something (taking the chance to showcase `executemany()`).

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

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

Merge pull request #1033 from Zaczero/shapely-srid

Add shapely SRID support.

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: fix running bin package workflow only 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.6

Merge pull request #1022 from psycopg/fix-target_session_attrs-prefer-standby

fix: implement libpq semantic for target_session_attrs=prefer-standby

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.

chore: rename tools/build library "ci"

The name `build` is problematic because we typically want to avoid tools
to go exploring them (mypy, isort, black...) but this leaves this
directory unexplored.

ci: install win32 libpq from conda force

chore: bump psycopg_pool package version to 3.2.6

Merge branch 'fix-transaction-after-check-master'

docs(pool): add release note about ticket #1014

fix(pool): reset connection transaction status after failed check

Close #1014

chore: bump build libraries

fix win32 libpq missing error

chore: bump psycopg package version to 3.2.5

chore: bump psycopg_pool package version to 3.2.5

fix(pool): check that there is some connection in the pool before shrinking

There is a race condition between shrinking the pool and closing an
expired connection which might result in attempting to pop from the
empty _pool deque. Add a check to prevent that.

The bug is not serious as it doesn't compromise the pool working but it causes
noise in the logging.

Close #1001

Merge pull request #998 from henadzit/cython-uuid

Add Cython UUID Loader

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(ci): drop stale comment

ci(crdb): enable back 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: add missing dependency to run isort --color

ci(crdb): suspend testing with 25.1

There are some failures with the current image, reported upstream.

chore: tweak linters output in pre-commit

Merge pull request #1006 from psycopg/isort

Use isort to standardise imports

chore(isort): add source link to project metadata, tweak readme

style: apply isort on codebase

chore: add isort configuration

style: add isort plugin to sort imports with the desired style

Sort imports by length, imported objects naturally.

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 docstrings 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 pull request #986 from psycopg/build-libpq-macos

Build libpq on macOS

ci(binary): less verbose libpq build

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 pull request #989 from psycopg/fix-clobbered-error-on-disconnect

Fix clobbered error on disconnect

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

docs: improve organization of adaptation objects docs

Move the life cycle section above the examples, closer to the
configuration top section; explain better how `format` affects the
loader used, highlight better the connection between the protocols
defined in the `abc` module and the abstract base classes in the `adapt`
module.

The meaning of `Loader.format` wasn't explained anywhere: see #990.

docs: fix ']]' return value in Dumper.get_key() docs

Close #921.

Merge pull request #982 from psycopg/cleanup-compat

Clean up compat modules after dropping Python 3.8

chore: fix problems reported by mypy 1.14.1

chore(tests): drop Python 2 check

refactor: remove unneeded objects from _compat modules

refactor(tests): remove Counter from utils module

chore: drop pre-3.9 if blocks

refactor: replace list comprehension with generators in multiple assignments

refactor: use pytest canonical assert method names

refactor: drop deprecated collection.abc aliases

refactor: use re objects for typing of Match and Pattern

docs: suggest using pyupgrade when dropping a Python version

run through pyupgrade --py38-plus

Merge pull request #980 from psycopg/pre-commit

Add pre-commit hooks

docs: document pre-commit usage