Use now available "postgres:14" Docker image in CI

Install libpq 14 in for some tests CI jobs

We add "libpq" matrix axis and select version 14 against various server
versions.

Add libpq interface for pipeline mode

Bindings are conditional so that compilation works with libpq version
older than 14.

Add a couple of tests inspired by PostgreSQL's tests.

Merge branch 'python-3.10'

Document Python 3.10 supported

Build Python 3.10 packages

Test with Python 3.10

Upgrade testing dependencies

Some are required for Python 3.10

Upgrade flake to 3.9

This version reports an error if a name is declared but not defined, so
set the lazy imported objects to None and deal with mypy complaining.

Improve test workflow

- Quote Python version number because 3.10 will cause issue as number
- Use 'postgres' instead of 'image'
- Add vim folds

Work around new delocation failure on Windows

https://github.com/psycopg/psycopg/runs/3754213309?check_suite_focus=true

Not sure this is the right thing to do, if we are pulling in the right
dll.

Merge branch 'postgres-14'

Add supported systems in the docs

Add info about multirange types

Replace 'TypesRegistry.get_range()' with more generic 'get_by_subtipe()'

Simplify the types registry using a single map

Allow PSYCOPG_TEST_DSN to be an empty string

This allows to configure the test database by only using the PG* env
vars, while still leaving the option to wreck a database opt-in.

Add PostgreSQL 14 to the test grid

Adjust test on PGconn.tty for libpq 14

Quoting https://www.postgresql.org/docs/14/libpq-status.html:

  [PQtty] no longer does anything, but it remains for backwards
  compatibility. The function always return an empty string.

Or perhaps we should drop 'tty' property (and binding), since this is at
least obsolete since PostgreSQL 7.4?

Document that the ProactorEventLoop is incompatible with Psycopg

Improve error message if proactor event loop is used on Windows

Merge pull request #84 from CaselIT/asyncio_and_windows

Improve async story in the test on windows

Support py36, test exception

Require selector event loop on windows; enable aync tests

Fixes #76

Fix doc for Notify

Probably autoclass is confused by the class module being changed.

Print a log instead of a warning on swallowed exit exception

Drop TODO points covered by the _dns module

Merge branch 'no-connection-encoding'

Document that client_encoding is gone

Drop Connection.client_encoding attribute

Expose it as `Connection.info.encoding`, but use pgconn_encoding()
internally.

Add Cursor._pgconn internal property

Make encodings module private

Drop connection.set_client_encoding

The property might have been super useful in pre-unicode times, but now
it is really an implementation detail.

The connection encoding can be still changed setting the GUC or with a
PGOPTION or option in the connection params.

Fix beta release number to normalised form... again!

I seem unable to learn what that form is.

Drop "installing from source" from readme and install docs cleanup

Merge branch 'fix-dumping-by-oid'

Note fix of dumping by oid in news file

Improve AdaptersMap and Copy.set_types() docs

Fix BytesDumper return type annotation

Add C version of numeric dumpers by oid too

Better wording: writing to attribute -> setting the attribute

Fix selection of dumper by oid

Add a few dumpers which can deal with the different types and make sure
to register them so that the lookup by oid would use them. Because they
are slightly less efficient (with isinstance tests) we prefer to have
them only used by oid, instead of extending the domain of the dumpers
used in normal adaptation by type.

This commit only fixes the Python side. The C numeric dumpers require
more work.

Use natural iteration over pq.Format in parametrised tests

Better tests of dumping after set_types

These tests reveal that When there is a 1-n mapping between oid and
python classes, we might pick a dumper that cannot really deal with the
object to dump (for instance trying to dump an int to numeric with the
Decimal dumper).

Add news file to the docs

Allow to specify a custom adapt context on connect

Close #83

Fix beta release number to normalised form

Fix partially written comment

The issue was addressed before the comment could be written in all its ugliness.

Clear the prepared statements if the catalog might have changed

This could happen on DROP (and re-creation) of some object or on the
implicit drop caused by a rollback.

Issues happen if a prepared transaction is executed after an object has
been dropped: see
https://github.com/sqlalchemy/sqlalchemy/issues/6842#issuecomment-925131836

Postgres devs suggestion is to avoid to do that: see
https://www.postgresql.org/message-id/2220999.1632335261%40sss.pgh.pa.us

Improve range random testing

Make sure to create a numrange[] field instead of text, which would have
happened if the random selection in Faker.types_names() had picked an
array whose first object is an empty range.

Also extend the tests to certain binary range types which previously
couldn't be managed.

Fix a couple of imports as relative

Specify better that registering adapters only affects new object

It is unclear that registering adapters globally doesn't affect existing
connections, including the one used to fetch info... See
https://github.com/sqlalchemy/sqlalchemy/issues/6842#issuecomment-924425360
for instance.

Improve pq.version() doc

Expose the libpq build version as psycopg.pq.__build_version__

Merge branch 'add-shapely-adapters'

Use class instead of type to create shapely dumpers

Report a friendly message if the geometry info is not available

Create postgis extension if needed by tests, shapely tests cleanup

Move shapely test to the types package

Shapely docs cleanup

Fix test MultiPolygon geometry, add test for it

Pass test geoJSON as parameter, not with string interpolation

Parametrize input format too

Fix shapely documentation

Force different placeholder to increase the coverage

Import modules for shapely test only at runtime

Add tests for the Shapely adapter based on PostGIS

Make binary dumper the default one

The latest registered dumper is the one used by default if the %s
placeholder is used in a query. The binary one is preferred.

Rename module from types.geometry to types.shapely

In case in the future further adapters for geometry types are added,
this naming makes more sense

Handle memoriview and buffer data as well as bytes, better import

Add Shapely-based adapter for PostGIS geometry, and docs

Previous commits were messy due to some rebase gone wrong, moved them to
a single commit

Use class instead of type() to create the specific hstore dumper

The name is not variable so it's not useful to use the less common
constructor.

Raise a friendly exception if None is passed to register_*()

The most likely cause is fetching info and the object is not found.
Suggest that that's what happened instead of throwing an AttributeError
or anything else random.

Fix missing assert in test

Add acopy() helper to write async tests more similar to sync ones

Do not use the extended protocol in COPY

Error recovery is reported to be problematic (see #78).

Close #82.

Drop rename of PyFormat import in tests

It was to minimise a diff when it got renamed, but it's confusing using
old tests as template for new ones.

Change macOS name in installation documentation

Fix docs case typo

Small adjustments suggested by pyupgrade

Don't pass "utf8" to str.encode() and bytes.decode()

"utf8" is the default: not passing it is marginally faster.

Run DNS-related tests in CI

Make sure tests can run without installing psycopg_pool

Improve the docs index page

docs: wordsmith

Bump furo version for docs building

Provides fix for https://github.com/pradyunsg/furo/discussions/240

Improve migration docs

Merge branch 'build-src-wheels'

Unify sdist and wheel packages building

Drop building C wheel package

It cannot be distributed on PyPI, and it makes sense that it's built on
the client, so just distribute the .tar.gz.

Build pacakges wheels

Not doing so, packages will be built by the clients on install. Not
nice.

Add vim folds to package workflow

Fixed @Intevation url in the backers file

Fix requirement for furo

Fix xml dumper example

Bad query, use type name instead of oid.

Upgrade Furo docs theme to stable version

The previous version produced white flash changing page in dark theme.

https://github.com/pradyunsg/furo/discussions/230

(at least on my laptop - the problem might be compound with some
extension, because others couldn't reproduce the issue, and Furo author
says it only happened on long pages for them).

Fix tests retry if the failure leaves the connection in bad state

Docs typo: several way -> ways

Fix async SRV resolution

Also use separate fixtures to mock sync and async DNS resolution.

Bump to next beta release

Instructions for PyPI installation in the readme