docs: further wordsmith around IS/DISTINCT

Also restore lost link reference.

docs: explicit wording to clarify correspondence between `IS NOT DISTINCT FROM` & `IS`

chore: ignore type error reported by mypy 1.12, 1.13

If a generator returns None, the StopIteration.args tuple is empty. The
fact we explicitly checks for it and in that case we return none looks
now an error for Mypy.

I don't see an obvious way around it.

Maybe related to https://github.com/python/mypy/issues/1933 which is an
historical issue (opened in 2016).

Reported in https://github.com/python/mypy/issues/18073

test: avoid peer authentication in password change test

docs: document the version when TransactionTimeout was added

test: mark more tests as 'timing'

When the machine is under load, any tests relying on a timeout or a sleep is
subject to fail. Let's mark some of them as 'timing'.

chore: bump psycopg package version to 3.2.4.dev1

chore: bump psycopg package version to 3.2.3

Merge pull request #917 from psycopg/pg17

Create binary packages with PostgreSQL 17 libpq

docs: mention PostgreSQL 17 in binary packages in the news file

ci: install flex to build libpq

Required from PostgreSQL 17

ci(macos): fix dylib path for postgres 17 from brew

Libraries are now installed under `lib/postgresql/` under the brew
package directory instead of just `lib`.

ci(macos): update brew to install PostgreSQL 17

At the moment CI failed with:

    No available formula with the name "postgresql@17". Did you mean
    postgresql@16, postgresql@15, postgresql@14, postgresql@13,
    postgresql@12, postgresql@11 or postgresql@10?

But the formula appears available at https://formulae.brew.sh/formula/postgresql@17

So probably it's a problem that will disappear in a few days.

ci: bump to PostgreSQL 17 in binary packages

It is not possible at the moment to Upgrade OpenSSL to 3.3.2 because of
https://github.com/openssl/openssl/issues/25366

Close #852

chore: add PostgreSQL 17 TRANSACTION_TIMEOUT error

ci: Add PostgreSQL 17 to CI test grid, remove PostgreSQL 11

fix(windows): resolve absolute path to libpq

Might solve the problem mentioned in the comments in #912.

test(crdb): fix or skip tests that now run because libpq 17 is available

test: fix compatibility of tests with Python 3.8

Avoid using the |= operator on dictionaries, which is unsupported on
Python 3.8.

The test started mysteriously to fail... Turned out that it hadn't run
so far on Python 3.8 because the "latest" libpq was v16, but when it
switched to v17 it started to be executed.

fix: fix typo in PGRES_PIPELINE_ABORTED enum

Only in Cython and not explicitly used. Python had the right name already.

chore: test readme cleanup

docs(install): reorganise install page disclaimer

Show first the happy path and a GOTO usage, then all the possible
reasons why you are unhappy.

(I just learned that this is referred to as the Anna Karenina
principle).

docs: polish grammar in the install disclaimer

doc: explain better that binary packages are on a best-effort basis

Close #912.

chore: bump psycopg package version to 3.2.3.dev1

ci: fix SQLAlchemy 3rd party test

Something changed upstream? The package is not found in SQLAlchemy case,
needs sqlalchemy.

chore: bump psycopg package version to 3.2.2

Merge pull request #890 from edgarrmondragon/build-cp313-wheels

Build Python 3.13 wheels

docs: add update instructions for new major Python releases

docs: add Python 3.13 support news entries

docs: mention Python 3.13 supported in install docs

chore: add Python 3.13 to trove classifiers

ci: build Python 3.13 wheels

Related: https://github.com/psycopg/psycopg/issues/889

docs: replace fastapi events with lifespan

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.19.2 to 2.20.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.19.2...v2.20.0)

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

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

Fix typo in cursor table

docs: fix typo in Basic module usage

chore: drop debug logging in pq import attempts

It confuses people who enable logging too broadly. See #807.

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.19.1 to 2.19.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.19.1...v2.19.2)

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

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

refactor(c): avoid violating strict aliasing rule in interval binary loader

See conversation in #877

Merge pull request #877 from psycopg/fix-warnings

Fix warnings

refactor(c): more idiomatic type-punned pointer warning workaround

We are using memcpy in all the other cases.

chore(c): drop warnings related to breaking strict-aliasing rules

chore(c): drop warnings related to discarding const qualifiers

chore(c): declare notice_receiver as not raising exceptions

The function indeed doesn't raise exceptions, as the possible one is
handled internally. Avoid a Cython compiler warning.

ci: add test on strict aliasing warnings

chore: bump typing-extension version

Previously requested 4.4 is not compatible with the now requested mypy
version 1.11

chore: bump mypy

docs: reword to remove a typo

docs: document drop of support for macOS < 14 arm64 packages

See ticket #858.

docs: fix sentence in async notification docs

docs(sql): fix Composite/Composed imprecision

Close #862.

Merge pull request #774 from dlax/doc-libpq-cancelconn

document libpq 17 features

docs: document PGconn.change_password()

docs: document libpq 17 cancellation API

docs: set libpq version to '17'

Branch REL_17_STABLE is now available in Postgres repository.

Using this version is needed to build the documentation with the next
commit.

fix: drop string TypeAlias definitions from public modules

The definition of the aliases as strings breaks composition with other
types. For instance `DictRow | tuple` is not valid. We could ask people
to use strings on their own, but this is a regression anyway.

In this changesets only the types reasonably exposed to the public are
fixed. Others are internal and I don't think would affect anyone (or, at
least, we can ditch the blame and put it on the user...) Modules
considered to clean from string typedefs are:

- psycopg
- psycopg.abc
- psycopg.pq
- psycopg.pq.abc
- psycopg.rows
- psycopg_pool
- psycopg_pool.abc

Close #860.

fix(bump_version): take requirement suffix into account

It caused #853 and made so that version 3.2.0 had a lifetime shorter
than a fruit fly.

chore: bump psycopg package version to 3.2.2.dev1

chore: make typing-extension conditional to Pyton < 3.13

chore: bump psycopg package version to 3.2.1

fix: fix versions in packaging metadata

Close #853.

docs: fix title level of major releases

docs: mention dropping Python 3.7 in psycopg 3.2 release

docs: better organization of the 3.2 release notes

chore: bump psycopg package version to 3.2.0

chore: bump psycopg package version to 3.1.20

Merge pull request #846 from eli-schwartz/tomllib

build: avoid installing tomli on recent python

style: shorter line in pyproject.toml

build: avoid installing tomli on recent python

It is in the stdlib. No need to have wheel building require downloading
yet another build dependency.

fix: avoid to dump [multi]range as text when binary is requested

If a range has no type information (e.g. is empty and it is a base
class, not a specific range subtype), `upgrade()` would have returned a
text dumper. This would have resulted in protocol violation, such as
requesting unhealthy amount of memory to the backend... and it was
tested too!

Restoring sanity has a drawback. If we have an array of ranges, none of
which has type information, we now fail binary dumping. Previously this
worked, provided that a cast `::int8range[]` was provided, but I think
with an extreme stretch of the protocol: we were producing binary arrays
containing text representation of the ranges.

I don't think the latter is quite valid. So I have a preference for
dropping the feature in exchange of not violating the protocol. We trade
a better dumping of the basic type (an xfail less there) in exchange of
losing the ability of dumping an array of ranges, all empty, using a
cast, in binary format. Binary dump works using a subclass such as
`Int8Range` instead of `Range`.

The lost use case is so marginal that I don't feel the need to document
it. We don't even have documentation for the `Range` subclasses.

Merge pull request #847 from psycopg/update-libs

Update openssl to 3.3.1

docs: add release note about OpenSSL 3.3.x

chore: bump ldap version to 2.6.8

chore: bump openssl to 3.3.1

Drop fallback version in build_libpq.sh script. It was useful to save
some typing in development but now it is confusing to have two versions.

ci: more robust libpq build script

test: add missing fixture to multirange test

Merge branch 'ci-binary-build-fix'

ci: set macOS deployment target env vars

Seems required moving from cibuildwheel 2.16.5 to maybe 2.18.1.

chore: bump libpq to 16.3

Mostly with the intent to zap the cache.

ci: add openssl-dev dependency to build musllinux packages

chore: bump cibuildwheel version

test: use numpy 1.18 for real in minimal versions tests

Merge pull request #839 from psycopg/raw-server-cursors

Add RawServerCursor class

feat: add RawServerCursor class

fix: fix compatibility with numpy 2.0

The only meaningful code change is with the bool class, whose type name
changed from `numpy.bool_` to `numpy.bool`. Note that using `bool`
causes a FutureWarning on import for numpy > 1.20, therefore we avoid
testing it (we still successfully test the `bool_` alias).

Other changes are related to tests: certain constant aliases are no more
available, so we skip those tests conditionally to numpy version.

Pin a minimum numpy version, to make sure we test also a numpy v1.
Picking 1.18,  released back in Dec 2019, as it's the first minor
version offering binary packages for Python 3.8. This min dependency will
need to be updated when dropping Python 3.8 support.

docs(rows): add examples showing the rows returned by basic factories

Merge pull request #835 from psycopg/capabilities-has-closed-prepared

feat(capabilities): add has_send_close_prepared()

chore(capability): drop has_pgbouncer_prepared()

Document to use the `has_send_closed_prepared()` capability instead,
which is a necessary condition for PgBouncer support, and doesn't give
the impression to be sufficient.

feat(capabilities): add has_send_close_prepared()

Merge pull request #760 from psycopg/blocking-notifies

fix: lock the connection during a 'notifies()' call

With the previous implementation, it was possible to sneak an execute()
while the generator is consumed. This gives the false impression that
it's possible to use the connection while listening (see #756), which is
false for reason better explored in #757.

Therefore, lock the connection while listening to notifications. If
someone wants to mix commands with listening on the same connection,
they should do it collaboratively with an adequately short notifies()
timeout.

chore: drop pq enums aliases on connection and cursor

Unused in the codebase, and not documented. Only used in the test suite.

Merge pull request #794 from dlax/cursor-stream-chunks

feat: add a size parameter to Cursor.stream()

This triggers results retrieval by chunks from the server, if > 1,
leveraging the "chunked rows mode" from libpq 17.

A new has_stream_chunked() capability is added.

Merge pull request #834 from psycopg/cancel-conn-encoding

fix: typo

Co-authored-by: Denis Laxalde <denis.laxalde@dalibo.com>

feat: add get_error_message() methods

The method is available on PGconn, PGconnCancel, PGresult.

The generic function error_message() is retained only because it was
documented so we don't want to drop it. Internally only the
get_error_message() method is used.

refactor: make PGcancelConn.error_message return bytes

This is more consistent with PGconn and PGresult.

There doesn't seem to be the need of extending pq.misc.error_message as
we never pass it a PGcancelConn object.

Close #781

fix: fix PQclosePortal not supported error message