Avoid a cython call in bool loaders

It's probably inlined, but there is still the exception handler around.

Fixed overflow argument for float loader

Added documentation for Rollback

Merge branch 'nested-transactions'

More efficient float loading

Use "private" savepoint name to avoid conflicting with user ones

"s1" is too common.

Also omit ``savepoint`` in sql statements: it is a noise word

Added documentation for transaction management

Map errors 08* to OperationalError

See https://github.com/psycopg/psycopg2/pull/1148

Transaction tests cleanup

Fixed transaction behaviour when there is a transaction already started

State management simplified too.

Commands to enter/exit a transaction with named savepoint tweaked

- Batch together begin + savepoint
- Do without releasing the savepoint immediately before commit/rollback

Commands generation separated from execution in transactions

Commands and state change are independent from sync/async. Only the
execution and the interface is in the different sync/async subclasses
now.

Define at init rather than at enter if the transaction is top-level

Refactoring to minimize sync/async savepoint duplications

Added AsyncConnection.transaction()

Anonymous savepoints represented by empty string

It makes signatures and types easier. Empty string is not valid anyway,
and bonkers types are not checked.

Connection.transaction is a context manager

It will help to avoid an async with (await conn.transaction()) on async
connections.

Dropped now redundant copy test

Added asynccontextmanager for Python 3.6

Binary copy tests enabled: now there is an int binary dumper

Copy object interface simplified

Dropped methods and code paths no more useful now that the user can only
interact with Copy as a context.

Cursor.copy() made into a context manager

What was before was a factory function, however that forced to have a
pattern like:

    async with (await cursor.copy()) as copy

Now instead what should be used is:

    async with cursor.copy() as copy

With this change the user pretty much is never exposed anymore to a Copy
object in a non-entered state. This is actually useful because it
reduces the surface of the API: now for instance Copy.finis() can become
a private method.

Dropped now redundant copy test

Added asynccontextmanager for Python 3.6

Binary copy tests enabled: now there is an int binary dumper

Copy object interface simplified

Dropped methods and code paths no more useful now that the user can only
interact with Copy as a context.

Cursor.copy() made into a context manager

What was before was a factory function, however that forced to have a
pattern like:

    async with (await cursor.copy()) as copy

Now instead what should be used is:

    async with cursor.copy() as copy

With this change the user pretty much is never exposed anymore to a Copy
object in a non-entered state. This is actually useful because it
reduces the surface of the API: now for instance Copy.finis() can become
a private method.

Escape savepoint names

Added more internal support to the connection to generate internal
commands dynamically, thanks to the `sql` module now implemented.

Transaction fixed after rebase on master

First-cut implementation of connection.transaction()

Document COPY differences and async use

Work around Py2 api of PyFloat_FromDouble in Cython

https://github.com/cython/cython/issues/3909

Better use of Python api for numeric load

Float remains to be tweaked, as affected by
https://github.com/cython/cython/issues/3909

Added C float and binary bool loaders

Simpler bool loader implementation

Trying to dump int as int8, added binary dumpers for int and float

Get oid numbers from builtins dict

Now it's accessible after it was moved to the main package.

Really update types on PostgresQuery.dump

Let's do what it says on the tin, before micro-optimising.

Docs build script path fixed

Added more documentation on COPY

Don't throw an error using COPY TO in a block

Cleanup of Copy attributes and parameters

Using generics to describe sync/async types

First cut of cursor documentation

Virtualenv to build the docs renamed to .vemv

Trigger docs build on push

Import, but don't expose, documented objects in the package.

Added support to build docs unattended

Added failing tests to remember to implement connect_timeout

More Connection documentation.

Dropped Connection.status

It is almost a synonym of closed. Will add an object to get all the info
from the connection.

More docs

Dropped Connection.pyenc and related support

Connection.client_encoding is now guaranteed to be a Python codec's
name.

Adding an embryo of documentation

Dropped use of `send()` on Connection.notifies generator

`close()` is good enough.

Allow omitting the conninfo param instead of requiring an empty string

Dropped unneeded escaping loading int from bytes

Errors and builtin oids updated to PostgreSQL 13

Added connection enter/exit

Just a simplified version, only commit/rollback + close, waiting for
nested transactions...

sql.SQL.format() accepts any Python object, making it a Literal

Load the uuid and network modules lazily

The uuid module is slow to import (was fixed in psycopg2 2.4.3, but
there is no ticket open for it). Similarly, lazy load other non-default
modules.

Fixed comments in tests

Use pytest tmpdir fixture

AsyncConnection.cursor() made async

Dropped excessive use of is [not] None

It was done with the assumption that it is faster, but it is only in
C/Cython, not in pure Python.

Dropped local variable micro-optimization

A long time ago it was a thing. timeit shows it isn't anymore.

Added TypeInfo representation

Added int subtypes to cast to specific sizes

Use oid 0 for unknown typed and string casting

Using unknown (0) oid instead of text (25) works better to throw normal
strings at typed targets (e.g. columns) and expect them to work, a
behaviour similar to client-side binding. However Postgres < 10 refuse
to emit columns with unknown oid.

Dropped dumper param of Dumper.register

Just use `cls`, as the class method is available to all the subclasses.

Added network types

Fast codec functions moved to an utility module

Text dumping raises DataError if it contains a NUL byte

Note that psycopg2 was raising ValueError, but DataError is more
appropriate. If the param is binary, Postgres will raise
.CharacterNotInRepertoire, which is a DataError subclass.

Callproc can take both args and kwargs

sql.Composible subclasses super c'tor before raise an exception in init

If an exception is raised a test framework may raise an exception on
repr.

Added cursor.callproc()

Cursor is iterable

Using type Iterator instead of Generator when possible

Added columns attributes

oids module moved from psycopg3.types to psycog3 package

Importing it from types caused too many side effects.

Added UUID type load/dump

Use static attributes to declare dumpers oid where possible

Dropped type guards for dumpers/loaders registration

Awkward to maintain and badly defined. Let the ducks quack.

More uniform loader/dumper names

Added test to make sure binary minus in client-side binding works ok

Fixed tests with PostgreSQL 9.6 and previous

Such database version doesn't allow to emit unknown oid literals.
However specifying a different type for unknown, such as text, will fail
as soon as the value is used in a typed context, which is a far more
useful use case.

Fix test when a db name is not set

Dropped duplicate tests

Dropped loader param of Loader.register

Just use `cls`, as the class method is available to all the subclasses.

Fixed rowcount with DML queries, multiple results, executemany

Use unknown oid passing NULL to queries

Passing text makes for a cast rejected by fields with a stricter cast.

Diagnostic objects can be pickled and error info survive pickling

Errors can be pickled

Raise InterfaceError on operation on closed objects

Added cursors context managers

Merge branch 'sql-module'

More idiomatic python3 super()

Added Dumper.quote()

Return a representation of the object in a format useful for embedding
in SQL. For most objects this is only the representation in quotes and
escaped, for some it's a different value (numbers, bools, NULL).

None can be quoted but not dumped, so it can be passed to an
sql.Literal() without the need of a special case.

sql.Placeholder can represent binary placeholders

Move conversion of Composible to query string into PostgresQuery