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

Update classifiers to beta state

Update install docs to point at PyPI

Bump version to beta 1

Add function to perform SRV DNS resolution

Allow to intermix local addresses with DNS async resolution

Point out in async connection about blocking DNS and solution

Rename _dns docs page to dns as non compatible with GitHub pages

Merge branch 'async-dns-dnspython'

Add _dns module docs

Keep env vars into account in async DNS resolutions

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