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

Drop unused import

Merge branch 'binary-numeric'

Improve wording of docker testing notes

Add example about running tests in docker

Writing it down as I have to hack it together every time.

Fix dumping Decimal of the form 0E+n

Fix test for ConnectionInfo.hostaddr and libpq < 12

Add script to test the pool performance

Add benchmark test for binary numeric

Conclusion is that for the moment it is better to leave default Decimal
dump to text format. Better performance can be obtained accessing the
Python C Decimal structure and perform conversion from there.

Use faster C mod operator in Decimal dump

Add C implementation of Decimal dumper

Don't dump an excess of right 0's in Decimal to numeric

Add Cython implementation of NumericBinaryLoader

Add C implementation of text decimal adapters

Add dumper for Python int to numeric

Handle Decimal sNaN value

Dump numeric as binary without manipulating the digits tuple

Will make for a much faster algorithm in C

Decimal binary dump algorithm streamlined

Add Decimal values to random tests

Add prototype for a decimal binary dumper

The algorithm is pretty unwieldy, maybe it can be refactored. But tests
show that it should be correct.

Upgrade testing libraries (#50)

Use latest versions of testing libraries

pytest is broken on Python 3.10, until version 6.2.4.

Add numeric binary loader

Add pytest marker to skip tests on certain server versions

Fix typo in doc title

Check documentation build in CI

Add regression test for the infinity date example

Add an adaptation example for infinity date

Take from https://www.psycopg.org/articles/2020/11/24/psycopg3-adaptation/

Bypass call to _get_optimised if using the Python implementation

Dumpers ownership dict micro-optimisation

Copying is ~10x faster than creating a new dict.

Fixed adapters copy-on-write

If a wider context is customised don't affect smaller contexts already
created.

Use an explicit dumper map for the auto format.

The dumper chosen in auto format is the last one registered, if both the
text and binary ones are available. For all the builtin types the
preferred format is binary, except for strings and for json.

Dumping strings as text by default was handled by a special case; now
they are just handled by registering the text dumper after the binary
one. Json is now text by default, because it's marginally more
efficient.

Fix a typo in adaptation documentation

Merge branch 'type-row'

Further negotiation for good row types docs

Improvements can be made, however I would rather merge this branch to
master and improve the whole docs.

Proofread row factories doc

Improve row factory docs

Describe the protocol objects too. Expose them in the `psycopg3.rows`
module.

Add typing docs and example for psycopg3.rows

Drop RowConn from proto

Use a more local CursorRow definition.

Define an AnyCursor type alias

This will make it easier to define custom row factories without having
to use BaseCursor[Any, <rowtype>] as the connection type is not
meaningful in this context.

We expose this name instead of BaseCursor in top-level package
accordingly.

Bump up tests timeout on github action

Add typing test for cursor iteration

Fix typing of server-side cursors fetchmany/fetchall

Fix `Connection.connect()` return type

Now `connect()` returns a `Connection[Tuple]`, whereas
`connect(row_factory=something)` return the type of what row factory
produces. The implementation of this is somewhat brittle, but that's
mypy for you: @dlax (thank you!) noticed that defining `**kwargs:
Union[str, int]` helped to disambiguate the row_factory param. I guess
we will make a best-effort to maintain this "interface". Everything is
to be documented.

Strangely, mypy cannot figure out the type of

    conn = await self.connection_class.connect(
        self.conninfo, **self.kwargs
    )

in the async pool, but it can for the sync one (without the `await`).
Added explicit type to disambiguate, on both the classes, for symmetry.

Added regression tests to verify that refactoring doesn't break type
inference.

Illustrate type annotations in row factories documentation

Check test_typing with mypy as part of the pytest run

Make Connection generic on Row

We use a type variable 'RowConn' for Connection that is distinct from
'Row' that is used on Cursor side in order to reflect the possibility to
have distinct row factories on connection and cursor sides.

In order to avoid "propagation" of the Row type variable of Connection
classes, we use Any everywhere that variable is not used (namely,
everywhere outside the connection module).

The typing_example.py almost works: connect(row_factory=...) returns a
typed Connection, but only connect() still returns a Connection[Any].

Define Connection's row_factory as a property

This is similar to Cursor class and will make things easier in following
changes, making Connection generic on row type.