docs(pool): a proto-only SQLAlchemy url suffices as we are passing a creator

docs(pool): consistent sync/async examples in SQLAlchemy NullPool example

docs(pool): add documentation for close_returns

fix: add close_returns to NullConnectionPool

feat(pool): add close_returns

Behaviour implemented via subclassing Psycopg 3.2.

Close #1046

feat(pool): add connection subclasses to enable putconn-on-close

test(pool): make sure that returned connection have the pool set

The flow where we set _pool = None or _pool = self is a bit complex.
Make sure we don't mess it up.

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>

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