More care in None return values from libpq result functions

Added barebone implementation of dbapi 2.0

Several methods not tested yet, fetch method not added yet to async
cursor.

Fixed some shenanigan around connection params

The libpq function return None for an invalid connection: take that into
account in the function signature and usage.

Dropped asymmetry between sync and async connection for the encoding
setter: use for both a set_client_encoding() function. This way it's
easy to keep the getter on the base class.

The big rename: adapters -> dumpers, typecasters -> loaders.

Fixed composite info query to work for pg <= 10

creating a row() on the fly caused the error "record type has not been
registered"

Added tuple text adaptation

It cannot return a record oid, Postgres is not happy to parse it, so
return it as text.

Fixed formats in query with repeated arguments

Fixed test that wasn't checking the format.

Added composite.fetch_info_async

fetchone() made async on async cursor

register_array() renamed to array.register()

Fixed registration scope of composite array adapters

Added typecasting of composite types

Added cast from varchar, bpchar, name

Note that bpchar (i.e. the output format for "char" - with quotes) and
name are always decoded, even if the db is SQL_ASCII, because these
types are mostly used in system catalogs and there should be no such
crap as unencded data there.

Added tests for all numeric types arrays

Dropped ArrayCaster, expose register_array function instead

The function only associates array_oid -> base_oid. Looking up the right
typecaster happens at cast time: this way composite adapters (record,
list) can use the caster register in the right context.

All the types for which there is an adapter gets an array caster now.

Really use the context to transform components types

It works for arrays and records, except for text arrays because the
decorator registers the TypeCaster directly, not the oid. This must
change, we need a different decorator/registration.

The Transformer is an adaptation context

Dropped cursor from Adapter, TypeCaster, Transformer. Added adapters and
casters map on Trasformer.

Solves a problem of customization in composite types: if a type is
customized now composite types containing that type use the same
customization. Also fixed a circular reference between transformer and
cursor.

Work around mypy error of Format not exposed by psycopg3.adapt

Added binary cast of record type

Added Transformer.cast_sequence() in place of cast_row()

The function is more generic and the Transformer doesn't have to wrap a
PGresult anymore.

Added text cast of records

Dropped accepting None as Transformer.cast() input

More efficient if we only accept non-null results.

Less global objects in types.array module

Added xfailing tests to remember what is left to implement

Cleanup of the array adapter algorithm

Check that arrays contain consistent objects.

Dropped spurious comment

Added adaptation of binary arrays

Added binary array adaptation for test types and some numeric types.

Consistent name of 'format' parameter

Also really use function caches in Transformer

Consistent 'src' name for the first argument of the adapters

'cls' is messy when it comes to class methods.

Added cast of binary arrays

Fixed typing typo

Adaptation context transferred to the adapters objects

Use classmethod instead of staticmethod to play better with inheritance

Added array tests for sql_ascii db and bytea

Fixed TypeCasterType and AdapterType types

The previous signature meant an instance of Adapter/TypeCaster or a function,
but we meant a class actually. The error costed some cursing and some
casting to the right type (in mypy sense, not in psyco sense)

Added wrapper for escape_bytea with no connection

Changed unescape_bytea to be a normal method. The pgconn is now
optional.

Typecaster renamed to TypeCaster

Because I have ArrayCaster, will have RangeCaster etc.

Added basic array adaptation infrastructure

Fixed names of wrapper functions

Added object to map oid and data types

Added array delimiter to the data types info

Cleanup of the encodings table and lookup

Handle sql_ascii encoding as binary

Added pq.Escaping object and bytea adaptation

Added connection.encoding

Added bytes adaptation

Added binary typecasting of int, float, bool.

'pgresult' is part of the Cursor interface

The same way 'pgconn' is a public property of the Connection.

Modules import to register builtin types moved to types package

exceptions module renamed to errors

To be part of the public interface, for compatibility with psycopg2

Module adaptation renamed to adapt

I figure out this is part of the external interface. Let's give it a
nice name.

Added text types conversion for numeric types and bools

Plenty of tests, too.

Added tests about adapters/casters selection, some fixes

- Added Transformer.cast() function;
- Can return binary results even with no input parameters;
- libpq functions accept sequences rather than lists.

Include None in AdaptContext

Using Union[None...] instead of Optional[... is a choice. None has a
meaning, it means global, not optional.

Definition with a wrong default changed into declaration

Added mypy tests on travis

Added install instruction to readme

Use == instead of is to check the Wait states

Now they are integers so is, while it works, is an implementation
detail.

Use the selectors module instead of select

Choose a better way to wait for readyness than select if available.

Also fixed an error in both sync and async waiting: don't discard the
result of send().

setup.py fixed

Sub-packages weren't installed. Now it should be possible to install it
using:

    pip install "git+https://github.com/psycopg/psycopg3.git#egg=psycopg3"

Note that it was already possible to do so using

    pip install -e "git+https://github.com/psycopg/psycopg3.git#egg=psycopg3"

Added license

Added types stub for ctypes functions

Another couple of functions marked as returning Oid

Solved problem with namedtuple index

There's already a method index on the nametuple :D

Added Oid type

Fixed problem with adapters decorators

Now mypy --strict passes 100%

Added most type annotations

mypy almost passes in --strict mode

Also run mypy on tests and setup

Added mypy config to tox.ini

First pass of mypy annotation

Just fix what doesn't make mypy happy

Dropped local encoder/decoder in int adapters

Premature optimization, and leaks in the globals adapters maps, which
are otherwise very readable in modern Python versions.

Oid map updated to PG 12

INVALID_OID moved to oids module

Fixed oids order

Added regtype spelling of data types to oid table

Adapter/caster register functions can be used as decorators

register function and global adapters map moved as class members

Adapters moved to the types package

Added map of types oids

Added adapter/caster decorators

Added register_adapter/caster functions

Making adapters/casters simpler

It can be either a function or an Adapter/Typecaster instance, in case
configuration based on class/oid/connection is required.

Adapter functions can optionally return an oid.

Separate Transformer into Adapter and Typecaster

There isn't much sense to have a single, more complex object, doing two
potentially unrelated things.

Added binary results from cursor

Added basic typecasting and cursor.fetchone()

Added sketch of adaptation layer

Added format enum

query2pg returns formats too

Allow b and s formats on query split

Verbose regexp to parse placeholders

Typoeoes

Skip certain tests on PG < 10

The server raises "could not determine data type" for pretty simple
queries of the form "select $1, $2, $3"

Should ask the PG devs if there is a workaround short of knowing the
oids.

Display libpq version on test header

Trying to work out which version is failing.

tmp

Skip test for waiting on send

It doesn't seem reliable

Added class_for_state() stub

Skip hostaddr test for PG version < 12

Use 'async with lock' instead of deprecated 'with await lock'

Added PQlibVersion() wrapper

Skip importing PQhostaddr from libpq version where it's not available.

Flake8 config tweaked for black compatibility