ci: use separate build caches between psycopg 3.2 and 3.3

Introduce a suffix to change the cache key arbitrarily, to keep libpq
builds on different branches separate and not pollute each other's
cache.

fix: change default gssencmode to disable in built libpq

Fix #1136

feat: raise a warning if a GSS connection is obtained using the libpq default

Suggest the user to specify a 'gssencmode' setting explicitly so that,
in the future, we will be able to change the setting default to 'disable'.

Note: the warning in psycopg 3.3 is a runtime warning; in 3.2.x was a
deprectation warning.

See #1136

chore: restrict flake8 ignore on generated file to lines length only

Merge branch 'pg18'

feat: add `ConnectionInfo.full_protocol_version`

Add matching Capabilities methods too to allow checking if supported.

feat: add PGconn.full_protocol_version attributes

Wrap libpq 18 PQfullProtocolVersion functions.

See #1079

docs: mention PostgreSQL v18 support

ci: add PostgreSQL 18 to the test grid

chore: add PostgreSQL 18 exceptions

fix: add ConnStatus.CONNECTION_AUTHENTICATING value

Introduced in PostgreSQL 18

Merge branch 'fix-notifies-leak'

docs: document the changes to notifies generator

fix: raise a warning when notifies generator and handlers are used together

fix: collect notifies only if no handler was registered

If someone is listening to notifications by using an handler, the
notifies backlog would fill without ever being emptied.

This change has the risk of breaking something if someone is relying on
notifies being received both via callback and via generator, but I don't
know how to satisfy it without creating a leak to users who don't use the
generator. Will ask around...

Fix #1091.

Merge branch 'fix-executemany-lock'

fix: keep a lock for the entire duration of executemany

Before this change we had the lock context inside the pipeline context,
because conn.pipepline() and Pipeline.__enter/exit__ take a lock. But
this created windows of opportunities for other threads to execute
concurrent operations on the connection, resulting in "another command
is already in progress" errors.

Fix #1130.

refactor: auto-generate sync pipeline object from async one

refactor: separate sync/async pipeline in their own modules

refactor: introduce ALock/Lock in acompat

fix: fix excessive buffer resizing on int16 dump

Fix #1160

Merge pull request #1053 from psycopg/py314

Add support for Python 3.14

docs: mention Python 3.14 support in news file

test: fix pproxy compatibility with Python 3.14

Work around the issue reported in https://github.com/qwj/python-proxy/issues/200

ci: test with Python 3.14 non-dev

chore(test): drop use of asyncio event loop policy

Deprecated since Python 3.14

ci(alpine): install missing libraris required to test and package wheels

Since some recent alpine version the krb5-libs package is not installed by
default anymore. When building the libpq the package got installed as a
side effect of installing krb5-dev, but, in case libpq build was cached,
the libraries would have been missing when packaging the wheel or
importing psycopg for test.

chore: bump cibuildwheel to 3.1.4

It should help with Python 3.14 builds.

chore: add Python 3.14 to supported version metadata and docs

ci: add Python 3.14 dev to package build

ci: add Python 3.14 version to test grid

chore(tests): drop deprecated unittest redefinitions

Not used anymore in legacy tests.

doc: fix formatting of SQL command in documentation

docs: fix reST typo

docs: add notes about how to add libpq wrapper functions

Merge pull request #1140 from psycopg/add-used-gssapi

Add `PGconn.used_gssapi` attribute

feat: expose used_gssapi attribute to the public API

Already implemented in 3.1.10, but kept as internal implementation.

Fix #1138

feat: add support for libpq PQconnectionUsedGSSAPI()

We will not advertise its presence as PGconn.used_gssapi until Psycopg
3.3. However we can use it internally to implement a warning to check
the implicit usage of gssencmode=prefer.

See #1136

docs: fix confusing comment from readme

docs: drop pip upgrade info from readme

Most systems will have the minimum required version 20.3 already.

fix: fix typo require version X and greater -> or greater

test: use current timezone name

chore: bump mypy to 1.17 in dev extra dependencies too

Merge branch 'fix-binary-version'

fix(binary): fix __version__

It was taken from the psycopg-c package, so it might have been wrong or,
more likely, reported as 0.0.0.0 because not installed.

test: verify the version is sane

chore: bump mypy to 1.17

Merge branch 'cursor-results'

test: more comprehensive results() tests

Test the records returned, not only the generator results.

chore(async-to-sync): handle generator expressions

test: fix results() test

Test a server-side cursor for real, drop unneeded parametrization.

docs: cleanup of `results()` documentation

docs: document Cursor.results() and add rease note

test: test Cursor.results() method

feat: add Cursor.results() method

Merge branch 'fix-cancelled-error-shadowing'

fix(c): avoid a TypeError shadowing CancelledError on task cancellation

Fix #1005.

Merge branch 'dependabot/github_actions/master/actions-d86b61c7bf'

chore: drop i686 images build

It has become opt-in in cibuildwheel, so it's a good moment to remove
these packages.

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.23.3 to 3.0.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.23.3...v3.0.0)

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

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

test: fix failure in test_connection_warn_close

Create all the connections beforehand otherwise some may reuse the same
address, resulting in a duplicated warning message, which would be
omitted and fail the test.

fix: don't call str(self) or imported objects in __del__

We easily end up trying to access resources already unavailable in the
objects representation. In Python 3.14 this seems to happen aggressively
(or maybe it's just more visible because testing a dev version).

fix: change signature of SQL.join() to allow a sequence of Any

We declared accepting a sequence of Composable, but, because we passed
the joined values to `Composite`, actually non-composable were
interpreted as `Literal`.

Make this behaviour explicit by testing it and fixing the signature.

chore: run isort before other hooks

It's quicker to fail than mypy.

Merge branch 'fix-jsonb-function-caching-master'

fix(json): don't leak when lambdas are used as dumps/loads function

Cache functions on the code, not on the function identity itself:
different lambdas or local functions are different objects but he
underlying code object is the same.

Avoid caching if the function is a closure because it then becomes a can
of worms (if the argument is not hashable etc). Throw a warning in that
case.

Fix #1108

fix(json): don't leak when lambdas are used as loads function

fix: add missing interface for PGconn.protocol_version

Merge branch 'fix-1088'

ci: cancel concurrent binary build jobs

docs: mention fix in version 3.2.9

Revert "ci: install win32 libpq from conda force"

This reverts commit a05131ded8f1ec1816528341c5453fd586e70a4b.

Fix #1088

test: skip tests connecting to non-existing dbs for CRDB

For CRDB, every database exists.

test: make sure tests don't hang if default connection points to a closed port

They might hang is the server doesn't accept connections on the standard
port.

Tested by forcing the default connection to go to an unresponsive port,
using:

    export PGHOST=192.0.2.1
    export PSYCOPG_TEST_DSN="host=localhost dbname=psycopg_test"

and fixing all the tests hanging because they try to connect to the
unroutable hostname, not taking into account the test dsn.

chore: bump mypy version

docs(pool): fix random connection lifetime reduction: 5%, not 10%

Close #1100.

docs: fix errors in template strings docs

docs: fix typo

docs: add preview of template strings query documentation

chore: bump Cython version

Skip version 3.1.0 because of https://github.com/cython/cython/issues/6850
I understand that >= 3.1.0 is required for the free threading support (#1096).

fix(test): wait for thread end before reading process stdout

Should solve what seems a race condition on PyPy and free-threaded
Python (see #1096).

docs: cleanup logging section

As per kind dive-by review in #1085.

refactor(pool): add function wrapper to call either async/sync version

chore: use the github url in update_errors

The official repo raises a 429 and doesn't allow to download blobs
anymore.

chore: bump psycopg package version to 3.2.8

ci: avoid running jobs on pull requests

Jobs run anyway on push. This setting results in duplicate runs.

ci: make sure versions are strings, not floats

chore: add funding link to project metadata

fix(c): fix building on 32 bit with libpq 18

The previous code was protected by a HAVE_LONG_INT_64 macro.

chore(binary): bump OpenSSL to 3.5.0

On Windows the libpq 17.5 package depends on it.

chore(binary): bump libpq to 17.5 in binary packages

Merge pull request #1085 from psycopg/better-logging

Better logging

docs: add section about connection logging

refactor: more succinct expression for multiple attempts error

feat: restore connection attempts logging

It was deleted in #1076, with the introduction of the multi-message
exception but it is still useful, looking at #888.

ci: add Django LTS 5.2 3rd party integration test

ci: fix 3rd party test after the pip django package went lowercase

Merge branch 'libpq-v18'

ci: include PostgreSQL 18 libpq in tests

fix: fix building with PostgreSQL v18 libpq

Use 64 bits support from C99 types.

Fix #1082

chore(tests): import module only locally as it won't be imported/used in C