Add _dns module

Add a function to allow async resolution of the `host` entry in the
connection string.

The module is experimental and depends on the `dnspython` external
package, which is currently not installed as a dependency.

Small cleanup to conninfo docs

Add docs for conninfo module

Change link to postgres docs from v13 to current

Add pg_lsn to the builtin types registry

Update errors table to PostgreSQL 14

Reorder statements in a function where black didn't do a good job

mark compat module internal

Improve TypeRegistry docs

Add XML Dumper example

Make TEXT the default format for psycopg.adapt.Dumper and Loader

Add UUID, network examples in the docs

Add links out of the basic usage page towards more advanced topics

Improve rows documentation

Add api section, move from examples to theory instead of the other way
around.

xml adaptation example and more about types registry

Add composite types adaptation docs

Fix type var annotation

Add hstore docs

Add documentation for range types

Register array dumpers for oid lookups

This allows, among other things, to dump composite types containing array
in binary.

Add test to verify empty ranges can be copied in ok

Fix shortcuts examples

More standard adaptation docs

Drop docs topic I won't write

Merge branch 'dump-by-oid'

Add dumping by oid in the C implementation too

Return only the params from Transformer.dump_sequence()

The types and formats can be read as object attributes.

Replace git_row_types() with get_dumper_types/get_loader_types()

dump_sequence() can make use of the dumpers pre-set by get_dumper_types()
and is now used in composite binary dump and in binary COPY FROM.

The interface should be better iterated because for the latter use cases
the extra info (oids, formats) are just a waste of resources.

Only the Python implementation has been changed so far, the C
implementation will be changed down the line.

Use the composite type info to choose dumpers, instead of the Python type

This allows to dump composites in binary format without the need to use
object wrappers to specify e.g. the type of integer.

Add mapping oid -> Dumper in AdaptersMap

Make Dumper.oid a class attribute for C classes too

Make Dumper.oid a class attribute for every Dumper subclass

Merge remote-tracking branch 'origin/better-composite'

Add binary composite dumper

Drop TypeInfo.async_fetch(), use fetch() for both connection types

A more elegant way to customise TypeInfo registration in subclasses

Make register_composite(), register_range() the public interface

Drop subclassing of `TypeInfo.register()`, leaving it only for the base
task of registering type info and array. This makes them consistent with
other types which don't have a TypeInfo subclass of their own and only
expose a `register_*()` function (e.g. hstore).

Register composite dumper if the factory is a type

Expose the type as info.python_type after registering.

Clean up datetime adaptation docs

Don't use the generic name register_adapters

There will be cases in which there is more than one type in the same
module...

Verify that arrays of binary types dump correctly

More types adaptation docs

Drop TODO doc point to something that people can discover themselves

Let's leave devs some thrill, or this job becomes boring.

Add binary parameter to cursor.execute()

Drop Cursor.pgresult duplication in docs

Better style for Connection.pgconn docs. The old version of the cursor
attribute was better.

Document pgconn, pgresult properties

Don't use --no-deps to install the pool package

It shouldn't be required at the moment, the package doesn't have any
dependency (although it does depend on psycopg).

Readmes and metadata cleanup

Drop TODO point after understanding that Windows has no IANA db

Drop TODO point regarding Travis

On GitHub Action it's OK.

On flaky platforms these tests are skipped, so let's fail hard if the
proxy fails to come up.

Merge branch 'array-delim'

Dump lists keeping the type delimiter into account

Load arrays of types with delimiters different than comma (e.g. box)

Add "char" data type loading

Not very used so won't implement it in C, but useful to read catalog
data.

Fix typeinfo fetch of alt_name

It was returned as the binary value of the oid number.

Add oid to column representation

Please mypy and NoReturn function

Drop Cursor query, params attribute.

Document instead a `_query` object (renamed from the previous `_pgq`) as
helpful but subject to change.

Add cursor.statusmessage attribute

Drop Cursor.status property

Realign async copy tests to the sync ones

Drop TODO point now working

Add tests to prove it works.

More helpful error looking up for missing types in the registry

Drop TODO point on which I'm wrong

Drop TODO point for something that probably can't be improved

Add test for as_bytes method of sql objects

Add links to GitHub tickets related to DSN mangling

Add _get_connection_params method to connections

Move there the connect_timeout extraction logic, but the method is
intended to do more elaboration on the parameters before connection,
which should include asynchronous DNS lookup and possibly SRV lookup
(RFC 2782) and allows overriding in subclasses to allow experimenting.

Bump to next dev version

Use dev dependencies in tox checking

Allow to specify a them in a single place and not having to repeat
package dependencies in the mypy test.

Link mypy ignore comment to issue reported upstream

Fix building pool docs

Drop ConnectionInfo.protocol_version.

Of limited utility. Left exposed in the underlying pgconn obecjt.

Merge branch 'separate-pool'

Document that the connection pool is in a separate package

Build the pool package and include it testing other packages

Move the pool into a separate package

This would allow different release cycles from the core adapter.

Update doc building requirements

Drop requirement file from makefile, long gone.
Update furo, as the theme selector was broken.

Merge branch 'older-libpq'

Run windows tests in a way more similar to the built packages

Allow building the C module with older libpq versions

Mostly to work around the obsolete libpq version available for aarch64.

Merge branch 'split-async'

async_pool module renamed for consistency with other _async ones

Move the AsyncCursor implementation in its own module

Move the AsyncConnection implementation in its own module

Revert commit 044077e420471e86b51f1feecdc5927818db55d4.

Add @bloomberg sponsorship

Merge branch 'generic-row-factories'

Simplify rows example

Use class_row instead of making your own, drop the recipe that has
become class_row itself.

Add psycopg.rows.args_row and kwargs_row factories

Early bailout style in the row factory functions

Add class_row row factory generator

Move dict/namedtuple row factory cursor inspection outside row maker

The list of fields names is supposed to be cached at every query result,
not at every row.

Fix description for cursors returning no column

Fix a typo in ConnectionInfo.dsn docstring

Add pgconn.encrypt_password function

Include the '()' in the links to the libpq functions

This is more consistent with the rest of the documentation.

Some docs cleanup

Add ConnectionInfo.dsn property

Fix returning connection params in get_parameters() with empty default

"options" and "tty" were returned even if they were set to their
default.