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

test(crdb): skip tests where CRDB seems to misread binary numeric values

Reported upstream at https://github.com/cockroachdb/cockroach/issues/82492

test(crdb): adapt text tests

With this changeset, all fast tests pass on CRDB.

fix(crdb): keep into account duplicate oids iterating types in registry

In crdb there are a few aliases (e.g. json -> jsonb oid) which are not
adequately captured by the type's regtype.

fix(crdb): drop spurious quotes from multi-words regtypes

test(crdb): adapt numeric tests

test(crdb): adapt array tests

fix(crdb): pq tests adapted

test(crdb): skip tests relying on pg_backend_pid()

test(crdb): skip transaction tests, deadlocking on CRDB

I guess is it something related to rows locks and rollback. Will ask
upstream.

refactor: add NoneType to abc module

test(crdb): adapt or skip more tests to CRDB

fix(crdb): allow None roundtrip

Specify the TEXT oid for None, otherwise dumping with no context will
fail.

perf: add Transformer.__slots__

feat: allow to customize the oid to dump None

On Postgres >= 10, INVALID_OID is ok, because it has a fallback text
cast. CRDB doesn't have such cast, but can convert implicitly from text
to other types, so TEXT_OID is a better choice.

test(crdb): adapt pipeline tests

Transaction-related tests currently fail.

test(crdb): adapt cursor and error tests to CRDB

test(crdb): fix conninfo tests with crdb

fix(crdb): add generic records dumper/loader

test(crdb): make prepared statements tests portable between PG and CRDB

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.