test: fix skipping versions in parametrized tests

In the previous implementation, all the tests were skipped, because
annotations were added to the function and ended up affecting all
generated tests, not the marked ones only.

fix(crdb): fix type info of CrdbConnection.connect()

It requires specifying entirely the connect() signature because of by #308.

feat(crdb): add psycopg.crdb.connect() function

test(crdb): skip tests for unsupported types

feat(crdb): add CrdbConnection class

Drop the automatic detection of crdb. It seems dangerous to change the
program types based on external factors such as the database connected
to.

Generate and use a crdb-specific types oids map, on which to build the
adapters map.

fix(crdb): fix json adaptation

The function set_json_dumps() now adapts the currently registered
adapter, not the default one, to be able to customize the Json dumper on
CRDB, without resetting its oid to the PostgreSQL standard one, which
CRDB doesn't know.

fix(crdb): configure dumpers to deal correctly with Enum types

test(crdb): adapt datetime tests

test(crdb): add async copy tests

test(crdb): add copy tests

Skip tests from psycopg, because there is no support for copy out and
copy in syntax is different. Data types are different too (int/serial
mean int8) so the binary data samples don't match the format.

test(crdb): skip connection tests which cannot run on CockroachDB

test(crdb): fix most cursor tests to run with CockroachDB

Move some common test markers to the fix_crdb module.

Remaining cursor failing test may require some tweak:

- something with binary parameters
- something with ::text cast added by crdb dumper

test: refactor skipping tests by server version

fix(crdb): allow non-normalized encoding name from the database

CockroachDB returns what stored: "utf_8", "utf-8" etc.

All ConnectionInfo tests pass on crdb.

feat(crdb): cusomize CockroachDB connection

- Add ConnectionInfo.vendor
- Add ConnectionInfo subclassing
- Add CrdbConnectionInfo subclass with crdb_version attribute
- Add 'psycopg.crdb' module with adapters
- Dump strings using the text oid by default on CockroachDB

The latter change might have wider consequences, however crdb casts
strings to other types more easily than what Postgres does. At a glance
it might work; porting the rest of the test suite will tell.

test_adapt tests ported. Tests showing a difference moved to
crdb/test_adapt.

test(crdb): skip TPC tests

test(crdb): add fixture to support CockroachDB test/skip

Merge branch 'codespell-all'

chore: fix typos on previously missed files

ci: run codespell on the entire repo

test: register the pipeline marker consistently with the others

docs: fix a typo in literal string examples

Merge branch 'literal-string'

docs: add literal strings examples

Move the PEP 675 section to the typing page.

docs: mention LiteralString and related changes in docs

fix: clean internal use of LiteralString

Tested one-off using pyre 0.9.13; however it gives too many differences
compared to mypy to use it at the moment.

The pyre run doesn't currently find LiteralString-related problems,
except the todo at psycopg/sql.py:251, because string.Formatter.parse()
doesn't return a LiteralString upon LiteralString input.

refactor: restrict Query alias to use Composed or SQL instead of Composable

Other Composable subclasses (Identifier, Literal, Placeholder...) don't
make sense as a complete query.

feat: use LiteralString for Query and SQL aliases

Current mypy version probably doesn't do anything with it at the moment.

Merge branch 'async-dns'

test: use the flakey marker in random weight test, instead of a comment

refactor: drop dnspython implementation of resolve_hostaddr_async

Expose the asyncio function in the _dns module, but mark it deprecated,
because the connection perform async resolution on its own.

docs: add documentation about async DNS resolution

Close #259.

test: drop ipaddress lazy load test

The module is now used by psycopg.

feat: don't block on address resolution in async connections

Use the same algorithm implemented in the `_dns` module, but based on
asyncio getaddrinfo: this avoids the need of the external dns package
and works correctly with the /etc/hosts file.

There were problems of resource leaking in Python 3.6, but as psycopg
3.1 is 3.7+ only, let's go for it!

fix; drop check for libpq < 10 to use hostaddr

Hostaddr has been always available (seen in 7.2 documentation...).

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.

chore: bump version to release 3.0.15

Merge branch 'manylinux2014'

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: drop unused variable

test: skip flakey test on package build

Still can't find the reason why this test keeps on failing.

fix: sync pipeline before rollback()

We were syncing it already, but only if we had received a "pipeline
aborted" already. This might be not the case, as probably the tests
test_errors_raised_on_commit which has been failing in CI randomly for
weeks has been trying to say. Other similar branches (e.g. on commit)
don't have the same check for aborted state.

docs: fix a typo in infinity date adaptation section

Merge branch 'fix-315'

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

refactor: rename the no_pqexec param to force_extended

This refers to using the extended query protocol even in cases where the
singe query protocol might have been chosen instead (e.g. because we
don't have parameters to send).

The negative in the param name is confusing, and the reference to the
PQexec function is wrong, because we never use that function (which is
blocking), but rather we choose PQsendQueryParams instead of
PQsendQuery.

Merge branch 'message-0x33'

fix: don't use PQsendQuery in pipeline mode

There is no reason to use it: the only reason to not use
PQsendQueryParams is to send multiple statements, but this is not
possible in pipeline mode anyway.

Using PQsendQuery seems to produce a spurious Close message, which the
libpq is surprised to receive. Issue reported to pgsql-bugs.

https://www.postgresql.org/message-id/CA%2Bmi_8bvD0_CW3sumgwPvWdNzXY32itoG_16tDYRu_1S2gV2iw%40mail.gmail.com

Close #314

test: print notifications received in pipeline demo

Investigating on the conditions causing the messages reported in #314.

fix: use a generic return type to return self

Standardize the var name to _Self, waiting for PEP 0673.

Merge branch 'fix-stream'

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

test: add test to reveal unexpected message received

The test fails because we receive a notification:

    message type 0x33 arrived from server while idle

See issue #314.

Merge branch 'fix-copy-escape'

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: drop unneeded Cursor Row type variable from typing tests

Follow up 2f6e7669f0b32e7a99dd6db0ef41a18af119909f.

doc: fix a typo in pipeline examples

Merge remote-tracking branch 'dlax/pipeline-sync-upon-entering-nested'

test: fix str(Transaction) test relying on a broken behaviour

It was relying on the need of an extra sync fixed in #309.

fix: sync nested pipeline with pending commands upon enter

When entering a nested pipeline and the outer one has pending commands,
we now sync the pipeline. This is probably less surprising at it makes
the implicit transaction from a nested pipeline isolated from the outer
one.

With this, the explicit Sync when entering a transaction is no longer
needed.

Fix #309.

test: add test to show lack of generic connect typing info

See #308.

fix: fix ambiguous query to fetch enum details

The previous query happened to work, but was relying on a joined table
to maintain the order, which is not a documented behaviour.

fix: don't add a cast to text literals

Normally cast is not added to unknown literals, and the text oid is not
usually used. However, when it is, it causes problems. Often Postgres
wants just a literal, not a cast type; for instance, this is not valid:

    NOTIFY foo: 'bar'::text;

test: fix binary timedelta dumping text

We were testing text twice.

test: define the eur unicode char only once

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.

Merge remote-tracking branch 'dlax/row-covariant'

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

fix: use a more generic connection type in {Client,Server}Cursor

This makes them similar to plain Cursor class, i.e. being parametrized
on sync or async connection type, not the row type (which is handled
through the second type variable).

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

Make AsyncCursor code similar to Cursor one.

fix: sync pipeline after tpc_prepare()

This is to get the NotSupported raised directly when calling
tpc_prepare() as expected in test_tpc_disabled().

style: import PipelineStatus members in the module like for other pq enums

perf: micro optimise attribute access to PollingStatus

perf: micro optimise attribute access to ConnStatus

perf: micro optimise attribute access to TransactionStatus

perf: micro optimise attribute access to ExecStatus

perf: micro optimise attribute access to Format

refactor: while 1 -> while True

Brain legacy of ancient Python versions where the latter required a
global lookup.

test: fix for Python 3.11

The f-string expansion of str enums has changed. All the tests in the
maint-3.0 branch were already fixed; this changeset only fixes the new
ones.

Merge branch 'fix-304'