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

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