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

chore: import module to avoid confusing mypy situations

Merge pull request #1078 from psycopg/port-may-be-none

Fix port upon empty return from the libpq

fix: avoid a blank "port=" in the repr() of object with connection

fix: return the compiled port if PQport returns an empty string

Looking at the docs this seems the default value when an empty string is
specified, as opposite as the value in the PGPORT env var. See
<https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNECT-PORT>.

This change is an improvement on top of 40dfa0b, where we allowed PGport
to return NULL. This is likely a libpq bug (reported in
<https://www.postgresql.org/message-id/CA%2Bmi_8YTS8WPZPO0PAb2aaGLwHuQ0DEQRF0ZMnvWss4y9FwDYQ%40mail.gmail.com>)
but now it's in the wild so we better support it rather than dying of
assert or by int()'ing an empty string.

test: actually test server cursors when row makers return None

fix(c): don't use Cython 3.1 or following to build the extension

The resulting module seems affected by a memory leak.

https://github.com/cython/cython/issues/6850

Merge pull request #1074 from embecka/master

Fix loading of rows when row maker returns None

docs: add release notes entry about row maker returning none fixed

test: test behaviour of cursors with a row maker returning None

fix: fix loading of rows when row maker returns None

Close #1073

Merge pull request #1076 from danielfrankcom/dev/danielfrankcom/show-all-connection-errors

fix: show all messages associated with connection failures

fix: show all connection errors on attempt failure

ci: test integration of pool package with previous psycopg version

test: allow running tests with old psycopg versions

Merge pull request #1077 from psycopg/no-attempts-after-ctrl-c

Stop processing connection attempts after pressing Ctrl-C

fix: don't process further attempt if ctrl-c is pressed during connection

See for example #1055 where this behaviour is reported, #1076 where it
is further discussed.

fix: remove assert calling informative libpq function

At least calling PQport on a connection with multiple attempts ends up
returning a NULL instead of an empty string (libpq from Postgres 17.4).

Merge branch 'fix-1071'

fix[c]: fix interval parsing with day/month/year and negative time

Close #1071

Merge branch 'cleanup-py310'

chore: bump build packages versions

Update packages metadata following PEP 639 license documentation.

fix(test): work around error with issubclass(collections.ablc.Callable)

Reproduced only on Python 3.10

style: drop string type aliases

chore: drop redundant brackets

chore: drop use of deprecated aliases

chore: drop pre-3.10 compatibility hacks

Merge pull request #1064 from psycopg/cursor-next

Add support for `next(cursor)`

feat: make cursors iterators

This allows to call `next(cursor)`, which is guaranteed to never return
None, making type checking simpler.

Merge branch 'fix-server-cursor-rownumber'

fix: fix AsyncClientCursor.rownumber after scroll()

refactor: auto-generate sync server cursor from async

refactor: split async/sync server cursor in two modules

refactor(test): better parametrization of fetch type tests

docs: reword unclear news entry

fix: improve error message trying to fetch from a no recordset result

Print the last command status with the error. For example:

    the last operation didn't produce records (command status: NOTIFY)

or, if the result doesn't even have a command status:

    the last operation didn't produce records (result status: EMPTY_QUERY)

chore: drop support for Python 3.9

Close #1056.

chore: test support for PyPY 3.11

Merge branch 'fix-from-ticks-functions'

fix: fix return value of `DateFromTicks` and `TimeFromTicks`

These function are based on the return value of `TimestampFromTicks`.
Because this value returned by this function is timezone-aware and
localized to the current timezone, truncating the value (and implicitly
losing the timezone) might return the wrong result.

For example, at tick 0, in NY, it was 1969-12-31T19:00-05:00. By
truncating the timestamp on the date, the date would be the 1969-12-31
instead of the expected 1970-01-01.

This changeset actually changes `TimestampFromTicks` to return an UTC
timestamp instead of a local timestamp. We believe that this change is
not a problem because we don't change neither the type (tz-aware
datetime) nor the value of the returned object (old and new values
compare equal). An alternative would have been to decouple the Timestamp
function from the Date/Time functions, but I think it would be confusing
if the Timestamp function returned a datetime with the date in 1969 but the
Date function returned a date in 1970.

Adjust the tests to be *stricter* than before, making use of the fact
that now the output is not affected by the local timezone.

Close #1058.

docs: use "result set" consistently

fix `statusmessage` docs to reflect the fact that it refers to the current result, not the last one, as it was in psycopg2. Improve docs consistency about other attributes which might be affected by current result.

See #1062.

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.23.2 to 2.23.3
- [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.2...v2.23.3)

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

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

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

Merge branch 'connection-log'

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

docs: add link to pre-commit project in readme.

Also reflow a paragraph because it seems that the `-e` at the beginning of
the line introduces a line break in the Github rendering of the readme.

docs: drop references to Scaleway build scripts

chore: drop scaleway build support

We are now building arm64 packages on Github Action runners

chore: bump psycopg package version to 3.2.7

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.

docs: document multiple statements limitations

Close #1020.

Merge pull request #1031 from Zaczero/binary-hstore

Support binary protocol for hstore

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>