test: fail test session in case of segfault

Before that, tox reruns would have made tests pass, because failed tests
wouldn't have gotten a chance to be written in the cache.

Merge branch 'fix-372-3.0' into maint-3.0

fix(psycopg_c): propagate exceptions in Transformer.set_pgresult()

Fix #372

test: add test to verify the behavior of adapters failing init

An exception in loader init doesn't get raised and causes a segfault.
This reproduces the issue in #372.

refactor(psycopg_c): define loggers at module level

chore: bump to next dev version number

chore: bump to version number 3.0.18

Merge branch 'macos-broken-3.0' into maint-3.0

docs: add news entry about Homebrew fix

refactor: add find_libpq_full_path() to use both in library and tests

fix(macos): find the libpq in non-standard places

chore: upgrade QEMU to v2 for build

Also make sure to use a version not affected by bug #304

fix: make sure to pass a port number to getaddrinfo

Was passing an empty string by mistake, if no port was specified. Mostly
not a problem, except on some platforms, where it causes an
"unrecognized service" error.

Close #366.

chore: bump to next dev release

chore: bump to version 3.0.17

fix: load bytea as bytes, not memoryview, in Python implementation

fix: use a "finally" to clear the result pointer after handling notifies

The chance for this to fail failed is slim (an error in the logger? A
ctrl-c just there?) but a bit of paranoia has never hurt anyone.

perf(pq_ctypes): use the faster byref() rather than pointer()

Merge branch 'pgnotifyfixes-3.0' into maint-3.0

docs: add entry about segfault on fork fixed

fix: use a static notification function for PQsetNoticeReceiver.

The connection is passed via the optional *arg.

Fixes #300

chore: bump to next dev version number

build: build ldap with sasl and ssl support

Pass the libpq build prefix to configure in order to find just built
libraries.

build: upgrade system packages before building libpq

chore: upgrade libpq dependencies

docs: fix link to numeric-to-float recipe

ci: don't install modules in editable mode to run packages test

Something else that broke after setuptools 64 release. See tox-dev/tox#2479
for more details.

Reported something at pypa/setuptools#3557

refactor(psycopg_c): define and use an ARRAYSIZE macro

refactor(psycopg_c): drop deprecated use of DEF in Cython

See cython/cython#4310

refactor: expose optimized functions directly from the origin modules

Don't check for the availability of the optimized module in every module
using potentially optimized functions.

fix(psycopg_c): guard PQflush calls for invalid connections

Unlike other libpq functions, PQflush() doesn't have a guard for invalid
connections and will segfault if the connection gets closed.

Also check the return value of the PQflush calls: as we are not using
the wrapped version pgconn.flush(), the function doesn't automatically
throw an exception on failure.

chore: use `license_files` entry in metadata

`license_file` is deprecated.

ci: specify non-editable install in tox tests

Work around tox-dev/tox#2479 (editable installs in tox broken by setuptools
v64) and tox-dev/tox#2480 (failure to use `toxinidir` in `deps`).

Use -e consistently in the linting steps instead, because they are
defined with skip_install=True so it seems a good idea to use it. These
steps don't seem affect by the setuptools issue.

build(docs): don't exit with success if building html docs failed

Responsible of 2020-03-19 docs downtime. See #252.

build: use "latest" version of github builders

Merge branch 'build-macos-arm64-3' into maint-3.0

docs: mention macOS arm64 build script in news file

build: add scripts to build macOS arm64 packages

chore: bump version number to 3.0.16

Merge branch 'fix-343' into maint-3.0

fix: fix Cursor.rowcount after non-SELECT tuple-returining queries

PQcmdTuples doesn't return a value after SHOW and other type of queries.

Close #343

test: add tests to reveal the rowcount problem with SHOW

See #343

chore: re-export names to fix mypy 0.971 error

Merge branch 'docs-no-external-modules' into maint-3.0

docs: allow to read the libpq definitions from a local file

For the poor souls which don't have external access building the docs.
See #337.

docs: upgrade sphinx version to build docs

The version of furo used is not compatible with the newly available
Sphinx.

docs: fix build with sphinx 5.0

The `no_docstring` argument to `Documenter.add_content()` has been
deprecated in Sphinx 3.4.0 and removed in Sphinx 5.0.

This will not break compatibility with earlier versions, since the
`no_docstring` argument always carried a default value.

https://github.com/sphinx-doc/sphinx/blob/v4.2.0/sphinx/ext/autodoc/__init__.py#L601
https://github.com/sphinx-doc/sphinx/blob/v4.5.0/sphinx/ext/autodoc/__init__.py#L596

docs: move documentation from shapely module docstrings to docs

This avoids the dependency on shapely to build the docs.

docs: move documentation from _dns module docstrings to docs

Allow to build the _dns documentation without importing the module,
which requires external dependencies.

docs: add skip-list to avoid importing external module

In sandboxed environments dnspython doesn't work because it cannot read
`/etc/resolv.conf`/

See #337 for details.

test: fix proxy-based tests confused by the PGHOST env var

test: fix dsn manipulation tests confused by the env vars

Add fixture to clean up the PG* vars from the env and replace them with
the values to test.

docs: fix install instruction in docker to test the pool too

chore: bump to next dev version

chore: bump version to release 3.0.15

Merge branch 'manylinux2014' into maint-3.0

test: test wheel packages using PostgreSQL 14

Now all built packages support SCRAM authentication.

test: verify that we distribute the libpq we want to build

build: cache libpq build

build: build libpq 14 for musllinux packages

Currently Alpine ships with libpq 12, which wouldn't allow to use the
pipeline mode.

Use the system packages for the other libraries, for the moment.

build: build manylinux2014 packages

manylinux_2_24 is soon EOL and 2_28 will be incompatible with many
distributions to come. See <https://github.com/pypa/manylinux/issues/1332>.

Close #124

build: build the libpq from source when building wheels on centos platform

build: set expected sysconfdir in libpq shipped with the binary package

This affects where the pg_service.conf file is looked for.

See https://github.com/psycopg/psycopg2/issues/1365

chore: upgrade libraries to build binary packages

build: add script to build the libpq

Added as it currently is in the psycopg2 project.

chore: upgrade cibuildwheel to 2.6.1

refactor(copy) use already looked-up pgconn instead of the connection one

Left out of previous refactoring.

Merge branch 'fix-315' into maint-3.0

fix: raise DataError instead of OverflowError loading intervals too large

This happened only for the binary format, not the text format.

docs: mention different infinity date adaptation in psycopg2 differences pages

See #315

fix: produce consistent error messages on timestamp overflow

- State if the date is too small or too large, not just "not supported".
- Use similar messages in text and binary format.

See #315

fix: produce consistent error messages on date overflow

- State if the date is too small or too large, not just "not supported".
- Use similar messages in text and binary format.
- Avoid an overflow error with the infinity date in Python.

See #315

test: move date-related tests to the date tests class

Merge branch 'fix-stream' into maint-3.0

test: add test to verify stream+close interaction

fix: restore the connection in usable state after an error in stream()

fix: shorter tracebacks on stream() error

Merge branch 'fix-copy-escape' into maint-3.0

fix(copy): correctly escape non-printable chars

Postgres was doing the right thing with them, but the format was wrong.

perf(copy): avoid to call _write with empty buffer

There is a call per row we can avoid if the formatter is buffering the
data produced.

test: fix binary timedelta dumping text

We were testing text twice.

fix: drop "char" - character alias

"char", with quotes, is not an alias for character, bpchar is.
Don't rely on regtype to get its alias.

fix: don't emit a comma dumping timedelta objects

The format '-1 day, 23:59:59' is understood OK by PostgreSQL but it's
not documented so it seems unwise to rely on it.

fix: shorter traceback even on COPY statement error

The previous commit only addressed errors raised during transferring
data, not the initial COPY statement.

fix: shorter traceback on COPY error

fix: raise a shorter trackeback on interrupted notify connection

Test: fix mypy 0.941 run

This seems a mypy shortcoming fixed in 0.950 as the CI didn't complain.
The row factory definition was exotic but arguably correct. Not worth
bumping up the min version for it anyway.

fix: only use covariant Row type variable

The real variance of Row type variable is covariant, per definition of
RowMaker (RowMaker[B] is a subtype of RowMaker[A] if B is a subtype of
A; similar to the Box type in [mypy documentation][]).

By dropping the Row type variable from Cursor argument in RowFactory, we
are now able to only use the covariant Row variable (previously Row_co,
now Row). Indeed, RowFactory does not actually depend on Cursor on being
parametrized on Row; rather it's the other way around (Cursor's Row type
variable comes from its row factory).

[mypy documentation]: https://mypy.readthedocs.io/en/latest/generics.html#variance-of-generic-types

refactor: streamline 'type: ignore' in *Cursor.stream()

Make AsyncCursor code similar to Cursor one.

chore: bump to next dev version

Merge branch 'fix-304' into maint-3.0

fix: add C Float4 binary dumper

This should hopefully work around issue #304, at least when C is used.
When Python is used we raise an error instead.

Close #304

fix: raise an exception if the struct package is affected by issue #304

Cowardly refuse to transform ones in zeros.

test: Fix implicit f-string conversion to value

Behaviour changed in Python 3.11.

fix: Don't rely on f-string converting str enums in their values

The behaviour seems changed in Python 3.11: now f"%{PyFormat.AUTO}" is
evaluated as `%PyFormat.AUTO` instead of `%s`, for the general hilarity.

fix: fix typo: ingeger

chore: bump version to release 3.0.14

fix: don't barf on errors with blank sqlstate

Such messages are not entirely valid (sqlstate is documented to be
always present), however we receive them after a SHOW HELP in the
PgBouncer admin database.

The SHOW HELP actually does generate a sqlstate `00000` but the message
is somehow parsed incorrectly by the libpq, which goes on to report an
error:

    message contents do not agree with length in message type "N"

See #303. PgBouncer issue reported upstream in
https://github.com/pgbouncer/pgbouncer/issues/718

test: skip testing random multirange arrays with empty last elements

Previously we were skipping the ones with an empty first element,
because of a known shortcoming in finding the right OID. Now that we
scan the whole array to find all the elements' classes, it's the last
entry which might break dumping.

Merge branch 'fix-301' into maint-3.0