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

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