docs: document pre-commit usage

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.

docs: restore some lost comments in pyproject.toml files

Merge branch 'dont-lose-notifies'

fix: always gather the notifications received

Starting to register them after the first call to notifies() is somewhat
weird. We also risk to lose notifications in a case such as:

    conn.execute("listen foo")
    conn.execute("listen bar")
    for n in conn.notifies():
        ...

fix: don't lose notifications between notifies() calls

This allows to stop periodically the generator to run some queries (for
example to LISTEN/UNLISTEN certain channels) and start the generator
again without fearing to lose notification in the window.

Cloes #962.

Merge pull request #977 from stankudrow/drop-py38

Drop Py3.8 dependencies from `pyproject.toml`s and CI/CD workflows

chore: drop Python 3.8 support

Close #976.

chore: bump psycopg package version to 3.3.0.dev1

Merge pull request #974 from psycopg/convert-to-toml

Convert setup.py/setup.cfg files to pyproject.toml

chore: drop Download links from metadata

chore: adapt development tools to toml files

refactor(pool): convert setup.cfg to pyproject.toml

refactor(c): convert setup.cfg to pyproject.toml

Drop setup.py: move the build configuration to a build backend module.

refactor(psycopg): convert setup.cfg to pyproject.toml

Drop unneeded setup.py. The end of an era.

ci: move Python packages used for test into before-build script

ci(windows): use bash as default shell

Make packages-bin and tests workflow consistent.

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.3 to 2.22.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.21.3...v2.22.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>

Merge pull request #966 from trim21/try-vcpkg

Use vcpkg to install libpq on windows

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.