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

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: bump version to 3.1 beta 1 to test building packages

chore: upgrade libpq dependencies

docs: fix link to numeric-to-float recipe

fix: avoid all uses of PQconn.send_query in pipeline mode

We stopped using it in normal querying because, until libpq 14.4, the
libpq complained about "message type 0x33 arrived from server while
idle" (see #314). But usage remained for internal queries such as BEGIN.

In libpq 14.5, Postgres devs tried to fix the issue... and broke
PQsendQuery altogether :(

Hopefully the issue will be solved in future libpq versions, but we can
work around it completely.

Close #350.

feat: add pq._debug module to investigate libpq issues

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

test: add missing asserts

chore: fix typos spotted by codespell 2.2.1

Fix typo: shoul => should

docs: fix a typo in FileWriter docstring

fix: consider pipeline mode not supported with libpq 14.5

Improve diagnostics about the reason why the pipeline mode is not
supported. Improve not supported tests.

test: allow to use the != operator in make.libpq

feat: use version() as __build_version__ for pq python implementation

Having __build_version__ to be null makes version checking needlessly
convoluted and version() has to be used anyway as fallback.

refactor(psycopg_c): define and use an ARRAYSIZE macro

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

See cython/cython#4310

perf(psycopg_c): avoid to create a tuple in fetch_many() loop

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.

refactor: drop repeated operation in sync/async TypeInfo.fetch()

docs: fix typo "flaot"

docs: reword blurb about binary copy and make it a warning

docs: fix typo: "reurned"

Reurned... ⚱️ ->⚱️

docs: fix example and reword around multiple-query statements

docs: link to the "from psycopg2" page from the "basic usage" top section

docs: quote examples of pip install with extras

zsh doesn't parse the square brackets as expected.

See #347.

Fix syntax in example

build: use "latest" version of github builders

Merge branch 'build-macos-arm64'

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'

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

docs: mention 3.1 automatic DNS resolution in async page

Also fix several glitches in the dns page documentation.

docs: NOTIFY command in uppercase

Merge branch 'copy-writer'

docs(copy): add documentation for COPY Writer objects

refactor: unify code paths to set the rowcount

feat(copy): add 'binary' param to copy object

This allows to write binary format even when the query has executed no
COPY operation.

Notice that now we have introduced tests that convert sample_records
into sample_binary: because small numbers would be dumped to int2, use
values large enough to require int4.

refactor(cursor): rename _set_current_result -> _select_current_result

feat(copy): add FileWriter to write copy data to a file-like object

refactor(copy): rename QueueWriter to QueuedLibpqWriter

perf(copy): use non-thread/task copy writers by default

Further benchmarks show no performance improvement using a writer
thread, and a slight slowdown using a writer async task. If that's the
case we can keep it simpler.

docs: fix docstrings for copy objects

refactor(copy): rename ConnectionWriter to LibpqWriter

The class takes a cursor as input so the previous name was misleading.

refactor(copy): make the writer entirely responsible of the libpq copy state

This way we can create a writer which is entirely independent from the
libpq and the connection, which is useful, for instance, to format a
file with copy data.

feat(copy): add writer param AsyncCursor.copy()

Add async copy writers similar to the sync ones.

feat(copy): add ConnectionWriter

This writer allows direct writing to the libpw, without buffering queue,
and provides the interface for a writer using a libpq connection to
write.

feat(copy): add 'writer' parameter to Cursor.copy()

refactor(copy): add Writer object

This separation of responsibility will allow to:

- create writers that e.g. produce a file rather than writing to a
connection;

- create writers that write directly instead of using a queue (see
https://github.com/psycopg/psycopg/discussions/111 for an example of users
unhappy about that. I still don't see their nervousness justified, but
I'm ok to provide them an escape hatch if it's easy to implement).

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

Left out of previous refactoring.

Merge branch 'docs-no-external-modules'

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

Merge branch 'crdb'

test(crdb): test severity_nonlocalized on CRDB versions supporting it

test(crdb): tweak server-side cursors test to run on CRDB

Server-side cursors are well supported starting from CRDB 22.1.3.

docs: add note to test readme about testing with CRDB

docs(crdb): docs refinements

docs(crdb): add sentence to relate crdb adapters to pg ones

test: fix version check using proper PostgreSQL version schema

Previously to specify "libpq 14.2" it was needed to use 14.0.2.

test(crdb): add tests to expose canceled copy problem

See https://github.com/cockroachdb/cockroach/issues/81559

test(crdb): mark a few tests slow

test(crdb): add random copy test

Tests are currently skipped because of
https://github.com/cockroachdb/cockroach/issues/82792

test(crdb): don't use pg_backend_pid in pool tests

You can express the same test using info.backend_pid, which is supported
from CRDB 22.1.

test(crdb): add "suicide" tests

test(crdb): enable tests depending on backend_pid on CRDB 22.1

docs(crdb): include changes in CRDB 22.1

test(crdb): tag better the skip reason for server-side tests

Still skip all the other DECLARE tests; waiting for a couple of issues
being fixed in CRDB.

test(crdb): add tests related to session termination

test(crdb): use the crdb_skip marker

Enable cancel-based tests on CRDB 22.

test(crdb): accout for backend_pid supported since CRDB 22

test(crdb): add crdb_skip marker

test: allow to mark tests to run only or skip on certain version ranges

docs(crdb): add crdb module docs

fix(crdb): raise NotSupportedError on two-phase commit methods

test(crdb): add tests to test CHANGEFEED together with stream()

refactor(crdb): drop crdb_version; use server_version instead

The server_version returned by CRDB is a misleading dummy. The version
tested is reported as 13.0 but certain features are more akin to
different versions (e.g. lack of range support and different behaviour
w.r.t. unknown/text adaptation).

refactor(crdb) split crdb module into a package

test(crdb): get connection class from fixture to make sure to test CRDB objects

refactor(crdb): don't mix pg and crdb json configuration

fix(crdb): base context transaction tests on DML rather than DDL

On CRDB we may incur in problems caused by the table being dropped.

test(crdb): skip tests with arrays of json[b]

Not supported by CRDB: https://github.com/cockroachdb/cockroach/issues/23468

test: add json[b] arrays dump/load tests

Also refactor tests a bit to unify the json/jsonb in a parametric
format.

test(crdb): skip tests based on missing features

With this changeset, all tests pass or are skipped on CRDB 21.2.10 \o/

test(crdb): fix random tests

- Keep into account the different supported interval range
- Allow for float representation rounding (pre-PG 12 behaviour)
- Run leak tests in transactions to allow to recreate the tables