Stop using the psycopg3.types module as facade for all the types

Drop the psycopg3.wrappers package too and define the interface where to
take the wrapper to be psycopg3.types.MODULE

Merge branch 'binary-range'

Move basic struct-related functions to a common module

Use type-specific range subclasses to avoid the dump upgrade mechanism

This allows binary dump of empty ranges, for which the type can be
inferred. In normal dumping these are dumped in text format with unknown
oid but that would break binary copy.

Drop unneeded imports in types package

Probably they used to have side effects, overtaken by
register_default_globals().

Fix rounding error in float comparison tests with postgres < 12

Allow random testing with text format

Ranges are a bit complicated because upgrading empty ones only works in
text mode. This should be addressed, but hopefully it only affects
binary copy for now.

Test random range objects

Add range binary dumpers

Add Range.bounds attribute

Add RecursiveDumper, RecursiveLoader

Add range binary loaders

Fix interval and timezone parsing in copy buffers

Make tests.pq a module to allow relative import

Mark timing based test flaky

Insist more on the GC tests

Merge branch 'sql-as-bytes'

Drop TestSqlFormat::test_unicode

The same is already checked in test_pos_spec() method.

Auto-document Composable.as_bytes()

Make Composable an abstract base class

Drop inheritance from 'object' in sql module and tests

Trigger docs update to the website build workflow on GitHub Action

Don't require the virtualenv binary to build the docs

Add missing return type annotation

Find the failing value when a random insert fails

Fix float parsing when the data buffer is not terminated

Fix DB API Binary wrapper

Consider some tests flaky

They fail regularly enough in the github workflow

Drop timeout on workflow test step

Longer test run timeout

Fix reveal_type tests to mypy 0.901 output format

Better naming and typing for a couple of vars

Note that mypy has some issue there, so a "type: ignore" that seems
required cannot be actually added.

Merge branch 'connect-timeout'

Raise OperationalError for connection timeout

Add support for connection timeout

In *Connection.connect(), we replace call to make_conninfo() by the new
_conninfo_connect_timeout() utility function which builds the 'conninfo'
string (using make_conninfo()) and extracts the 'connect_timeout'
parameter.

For the synchronous API, this timeout value is then handled to
waiting.wait_conn(), to be used in the select() call. There, if select()
does not return within timeout, we raise a DatabaseError.

For the asynchronous API, it is passed to waiting.wait_conn_async()
where we use asyncio.wait_for() to wait for the event and also raise a
DatabaseError in case of timeout.

Build conninfo in *Connection.connect()

We'll need to extract 'connect_timeout' from the connection string and
use it outside Connection._connect_gen() in the next commit.

Merge branch 'network-binary'

Generate random ipaddress objects for testing

Add network types binary loaders

Add ipaddress binary dumpers

Drop utils sub-package

Merge branch 'c-datetime-adapters'

Add C interval text loader

Add C interval binary loader

Use consistently 'us' instead of 'ms' for microseconds

Pad second fractions to micros using a lookup table

Add timestamptz c binary loader

Add timestamptz c text loader

Drop code duplication in date/time parsing

Add c timestamp binary loader

Parse datetype without using endswith in c

Add c text timestamp loader

Add c timetz binary loader

Add helper function to return timezone from second

Use a cache to return the same object for the same offset.

Add c text timetz loader

Add c binary time loader

Add c text time loader

Add c timedelta dumpers

Add c datetime binary dumpers

Add c datetime text dumpers

Rationalise date dumpers inheritance tree

Add C time dumpers

Say "can't parse x", not "can't manage x"

These are parsing error. Stuff we can't manage (e.g. year < 10K) is
complained of elsewhere

Uniform date/time loaders naming

Just use the type name with one uppercase, no camels here.

Complete C date adapters, text and binary

Add C date loader

8x faster than the Python loader

Raise multi-line error messages with context

The context is not available in the diag error. Debugging without it is
pretty hard.

Make sure the error doesn't end with a newline, which is a complaint of
psycopg2.

Drop floating point dumping of datetime objects

The random test found rounding errors around year 2034.

Merge branch 'tzinfo'

Streamline fixed size dumpers by dumping directly in the output buffer

Drop unused import

Don't chain exceptions raising in decimal binary loading

Don't chain exceptions throwing DataError in dates

Load dates using slices instead of regexps

Some 40% faster. Thanks to @hakib for the tip :)

Faster date/timestamp parsing

Uniform interval parsing to the other data types

Base timestamptz loader on regexp

About 4.5x faster than strptime.

Base TimeTz loader on regexp

Further tweaks to date/time loaders

Base time loader on regexp

Some 5x faster

Base date and timestamp loaders on regexp instead of strptime

Not only is 4x faster, but it's more straightforward to port to C
and keep similar algorithms (even if we decide to drop regexp in C)

Separate date/time tests in classes

Fix datetime timezone adjustment on Python 3.6

Add test for timestamptz timezone load behaviour

Add docs and tests for ConnectionInfo.timezone

Move timezone attribute to the Connection.info interface

Type changed to the abstract `datetime.tzinfo` so that we have the
option to return something else such as a `datetime.timezone` with fixed
offset.

Added function to retrieve the object internally from the PGconn.

Warn only once about unknown zoneinfo

Return timestamptz in the connection timezone

First cut, more tests to add. All current tests pass, except the
explicit checks for UTC tzinfo returned.

See https://github.com/psycopg/psycopg3/discussions/56

Merge branch 'master' into binary-datetime

Make the dependency on typing_extension optional

Return timestamptz as utc datetime loading in text format

This makes text and binary loaders return the same value. It also fixes
the problem of the missing seconds in the timezone offset on Python 3.6.

The opposite choice, returning datetime in the connection timezone on
binary loading, doesn't seem really feasible: pytz cannot parse all the
Postgres timezone values (for instance, "+02:00" can't be parsed): take
a look at
https://www.postgresql.org/docs/13/datetime-posix-timezone-specs.html to
understand how much of a bad idea it would be.

Fix timestamptz binary tests with seconds in the timezone on Python 3.6

Consider loss of precision in negative binary timestamps too

Add timedelta/interval binary adapter

Add timestamptz adapter

Force text query in tests playing with datestyle

Just in case in the future we switch to binary return values and we stop
testing anything.

Add datetime binary adapter

Only for naive datetimes, timezone not handled yet.

Add timetz binary adapters

Add time binary adapters

No timezone yet, some tests fail.

Add date binary adapters