fix: make sure that intervals with days and monts have the same PostgreSQL epoch

While fixing #1071 I noticed that Postgres returns an approximation of
leap years in intervals with specified months and years. More precisely:

- Postgres internal representation keeps separate (micros, days, months)
  (as can be seen in the binary adapter).

- Years are converted to months. When pressed for an equivalence with
  days, this shows with:

    =# select '1 year'::interval = '360 days'::interval;
     ?column?
    ----------
     t

- When converting the interval to seconds, Postgres adds 1/4 of a day
  every 12 months (rounding to an integer number of years towards 0).

    =# select extract('epoch' from '23 months'::interval) / 60. / 60 / 24 - (365 + 11 * 30);
          ?column?
    --------------------
     0.2500000000000000
    (1 row)

    =# select extract('epoch' from '24 months'::interval) / 60. / 60 / 24 - (2 * 365);
          ?column?
    --------------------
     0.5000000000000000
    (1 row)

This MR implements a conversion from Postgres interval to Python
following the same rule. As a consequence, the `extract('epoch' from
interval)` function now returns the same number of seconds returned by
the `datetime.timedelta.total_seconds()` of the value returned. The
difference though is that the hours shows in the seconds:

    >>> conn.execute("select '1 year'::interval").fetchone()[0]
    datetime.timedelta(days=365, seconds=21600)

    >>> conn.execute("select '4 year'::interval").fetchone()[0].days, 365 * 4
    (1461, 1460)

This changeset only changes the Python implementation, not the C one.

Merge pull request #1072 from psycopg/fix-1071

Fix interval parsing with day/month/year and negative time

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

Close #1071

Merge pull request #1066 from psycopg/fix-server-cursor-rownumber

fix: fix AsyncClientCursor.rownumber after scroll()

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

chore: test support for PyPY 3.11

Merge branch 'fix-from-ticks-functions' into maint-3.2

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.

chore: bump psycopg package version to 3.2.8.dev1

Merge pull request #1052 from psycopg/connection-log

Add connection log info

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

chore: bump psycopg package version to 3.2.7

feat: implement binary hstore protocol

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.

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-3.2' into maint-3.2

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: rename some news.rst section headers from python to psycopg

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

Merge branch 'shapely-srid' into maint-3.2

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: run bin package workflow 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.7.dev1

chore: bump psycopg package version to 3.2.6

Merge branch 'fix-target_session_attrs-prefer-standby' into maint-3.2

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.

fix win32 libpq missing error

chore: bump psycopg package version to 3.2.6.dev1

chore: bump psycopg package version to 3.2.5

chore: bump build libraries

Merge branch 'cython-uuid-3.2' into maint-3.2

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: bump psycopg package version to 3.2.5.dev1

chore: tweak linters output in pre-commit

style: apply isort on codebase

chore: add isort configuration

ci(crdb): enable 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: 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 docstring 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 branch 'build-libpq-macos-3.2' into maint-3.2

ci(binary): less verbose libpq build

ci(macos): drop Python 3.8 build on macOS arm64

We weren't distributing this combination anyway even when linking to
Homebrew libraries.

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 branch 'fix-clobbered-error-on-disconnect-3.2' into maint-3.2

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

Merge branch 'pre-commit-3.2' into maint-3.2

chore: fix problems reported by mypy 1.14.1

docs: document pre-commit usage

ci: enable 3rd party tests on maint-3.2 branch

lint: add typing annotations to pass pre-commit

Pre-commit seems to run mypy in parallel batches, each with about 20
files. In this mode, certain tests that pass when running mypy all in
once or file-by-file, fail.

In the current state, both running mypy without arguments or running it
in pre-commit seem to work.

ci: configure lint step to run pre-commit

ci: add pre-commit configuration

chore: ignore certain files from mypy linting

Something weird happens. Certain files pass mypy lint on their own, but
not in combination. This is mostly related to `psycopg/pq/pq_ctypes.py`
and `psycopg/pq/_pq_ctypes.py`. This problem seems largely related to
incomplete ctypes definitions.

chore: drop annotation on empty lists, now unneeded

If needed, it is considered wrong anyway, because it should be annotated
as class attribute.