refactor: rewrite the pg_config stub in a more idiomatic way

ci: use vcpkg to install libpq on windows

test(windows): verify that the libpq used is what expected

fix: call the notifies callback while the notifies generator is used

Close #972

ci: bump runner to macOS 13

macOS 12 runners are now deprecated.

chore: bump mypy version to 1.14

docs: drop duplicate, out of place, statement

docs(pool): fix ticket link in news page

docs: extend `libpq` install instructions for cross-platform use

See #950.

build_macos_arm64.sh: Upgrade to Python 3.13 production release

chore: bump psycopg_pool package version to 3.2.4

fix(pool): print a warning if gather times out on del

In Python 3.13 something changed on interpreter shutdown and now
stopping threads on __del__ fails.

See #930, #954.

docs(pool): note compatibility with Python 3.13

chore: gitignore IntelliJ .idea file

ci: bump SQLAlchemy test versions

docs(pool): suggest closing the pool explicitly

On Python 3.13 threads may fail to stop.

See #930, #954.

test(numpy): account for 32 bits systems in size checks

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.21.1 to 2.21.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.21.1...v2.21.3)

---
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: use StopIteration.value instead of args as return after waiting

Work around the issue reported in https://github.com/python/mypy/issues/18073

Thank you very much, @brianschubert, for pointing it out!

Merge pull request #940 from 0xTiger/patch-1

docs: ensure operator in text and code example matches

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.