fix: set rowcount to the first result in executemany(..., returning=True)

Previously, _rowcount was unconditionally set to the overall number of
rows of all queries in executemany() and then reset only upon the first
call to nextset(). In the returning=True case, this lead the rowcount
attribute to be wrong for the first result (i.e. it didn't match the
number of rows that would be returned by .fetchall(), as can be seen in
updated tests).

Now we only set _rowcount to the cumulated number of rows of executed
queries *if* executemany() is not returning (so the value is still
useful, e.g., in to check the number of INSERTed rows):

    >>> cur.executemany("INSERT INTO t(r) VALUES (%s)", [(1,), (2,)])
    >>> cur.rowcount
    2  # number of inserted rows
    >>> cur.nextset()
    >>> cur.executemany("INSERT INTO t(r) VALUES (%s) RETURNING r", [(1,), (2,)], returning=True)
    >>> cur.rowcount
    1  # number of rows in the first result set
    >>> cur.fetchall()
    [(1,)]
    >>> cur.nextset()
    True
    >>> cur.rowcount
    1
    >>> cur.fetchall()
    [(2,)]
    >>> cur.nextset()

Besides, the code for processing results from executemany() in
_executemany_gen_no_pipeline() is now similar to that of
_set_results_from_pipeline().

refactor: drop superfluous _rowcount reset

In BaseCursor._set_results_from_pipeline() we were resetting _rowcount
if negative. This is superfluous as this code is reached when coming
from _executemany_gen_pipeline() in which we already do
'self._rowcount = 0' early on.

doc: fix typo unless -> unlike

refactor: drop internal use of Union[] type definition in TypeInfo.fetch()

fix: use more uniformly the to_regtype function

Make the knowledge of the function to use independent from the knowledge
of the types implemented by a certain database.

test(crdb): fix flakey test

We often find a "delete" record more than once in the changefeed, before
deleting it. Tolerate one.

Merge pull request #474 from CaselIT/to_regclass

Use to_regtype instead of ::regtype in type info queries

Use to_regtype instead of ::regtype in type info queries on supported dbs

fix: report the MultirangeInfo object exposed by psycopg.types.multirange

Merge branch 'build-backend'

ci: add in-tree build backend to avoid installing Cython if not needed

Only install Cython when there are pyx files to build. If there aren't,
it means that the c files are already available and Cython is not
required.

Close #471.

ci: use the 'build' python package as build frontend

ci: fix building source packages

Something was broken recently and installing from the package root
doesn't work anymore.

Merge branch 'test-lower-bound-depsendencies'

ci: include a single test with the oldest dependencies versions

chore: update the lower bound dependencies in the constraint file

Lower minimum dependency on pytest-randomly to version 3.5, as
version 3.6 requires a newer importlib-metadata.

fix: raise known errors before checking for signals in waiting

test: add psycopg2 in green mode to benchmark script

This is a more accurate comparison between psycopg2 and 3.

test: add --concurrency option to benchmark script

Investigate the poor parallelism mentioned in #448.

style: uniform variable name between sync and async cursor

fix: raise OperationalError instead of MemoryError on several operations

Failure is related to the operation executed, not to memory not
available to store the result.

chore: add Documentation, Changes links to metadata

feat(bump-version): add --actions option

Merge branch 'refactor-version-from-metadata'

chore(bump-version): find versions to maintain in setup.cfg files

docs: move comments about version scheme and coordination to setup.ini

refactor(pool): get package version from metadata

refactor(c): get package version from metadata

refactor: get package version from metadata

chore(c): lean win32

chore(c): fix build warnings on win32

ci: uniform and clean up test workflow

test(crdb): skip inet tests on v22.2.1

Work around https://github.com/cockroachdb/cockroach/issues/94192

chore(pool): add pyproject.toml

ci: configure the database to run two-phase-commit tests

We can't use the Github Actions PostgreSQL service because it doesn't
seem possible to configure the server for stored transactions:

- the service yaml definition doesn't take args to pass to run
- we can't overwrite the entry point with a script of ours because the
  service starts before actions/checkout
- the postgres image doesn't allow to pass extra parameters to the
  server via an env var

test: fix int mixin enum in test

perf: micro-optimize AdaptersMap.get_dumper

Minimal amount of opcodes in case of fast-path (there is an adapter
precisely for the class queried).

ci: separate source and binary package workflows

chore: bump psycopg_pool package version to 3.1.6.dev1

chore: bump psycopg package version to 3.1.8.dev1

test: mark another couple of tests flakey to avoid delaying releases

chore: bump psycopg_pool package version to 3.1.5

chore: bump psycopg package version to 3.1.7

feat(bump_version): create release tags too

feat(bump_version): update history file too

Merge branch 'fix-464'

fix: consider cursor description results in row factories

Fix #464

Merge branch 'detox'

test: drop --allow-fail and --no-collect-ok options

They were needed to deal with problem caused by tox. Not needed anymore.

ci: enable subprocess-based tests in ci

test: skip test on windows, C implementation, in ci

No idea why ctypes doesn't work, and I really don't care.

ci: drop tox from tests

Merge branch 'fix-438'

fix(pool): make sure that check() fills an empty pool

Close #438.

Merge branch 'test-crdb-v22.2'

test(crdb): re-introduce a mix of Python and libpq versions

Run tests against CockroachDB v22.2

v22.2 was released recently, so we can test it. This upgrade revealed a
regression in CRDB that we must workaround
(https://github.com/cockroachdb/cockroach/issues/93739).

This also removes testing for v21.2, since it is no longer supported.

ops: add script to bump package version

test: skip a flakey test on release

For 3.1.6 release, three package jobs failed on this test. One of them,
a ppc manylinux, took more than 30 minutes to rerun. Not pleasurable.

chore: bump psycopg package version to 3.1.7.dev1

chore: bump version number for 3.1.6 release

Merge branch 'fix-460'

fix(copy): don't create a row maker on copy

A COPY_OUT result has columns, but no names for the columns. This case
must be handled in cur.description (see #235) but we don't need to
handle it in copy. If we did handle it in copy, we would need a column
name fallback, which we forgot to handle, hence the problem in #460.

Close #460.

chore(binary): upgrade packaged libraries to libpq 15.1, openssl 1.1.1s

chore: bump to dev version 3.1.6.dev0

ci: run tests on Python 3.11 on macOS

chore: bump version number for 3.1.5 release

perf(rows): reduce row_factories overhead

Drop the call to cur.description, which is very heavy. Use the low-level
PGresult to get the fields names.

Close #457.

perf: drop call to pgconn_encoding per query

Cursor._encoding converted to property. It is only used in error
messages and infrequent operations.

Use uniformly the fallback value of utf-8 in *_encoding() functions,
especially when the connection is closed.

test: fix resource leaking in tests

It results in spurious warnings on ``gc_collect()`` in some innocent test
downstream::

    ResourceWarning: unclosed <socket.socket fd=14,
    family=AddressFamily.AF_UNIX, type=SocketKind.SOCK_STREAM, proto=0>

test: ignore error looking for leaks

The leaks counter frequently reports a leak between run 1 and 2 of the
tests. It turns out to be a Decimal Context whose items() method reports
no content. So the problem is related to Python, not psycopg, and it is
not an unbound leak.

Can't reproduce it in CI, but it happens on my laptop, since switching
to Ubuntu 22.04 with Python 3.10.

fix: don't re-export TypeAlias from _compat module

Pyright special-cases that type and requires to import it from typing or
typing_extensions only (see https://github.com/microsoft/pyright/issues/4197).

Drop conditional dependency on typing_extension and always import
TypeAlias from there.

Fix #439.

docs: fix ticket number in news file

Merge branch 'wait-select'

docs: report select speedup in news file

Close #411.

perf(c): add fast-call Cython function to PQflush wrapper

perf(c): small optimization tweaks to wait_c

test: skip high fd number test on Windows

Windows is pretty simple in regards of the wait function, because it only
implement select, and it doesn't have the same limit of the Unix select.

However this test sometimes fails in weird ways: on the pgconn.socket >
1024 assert, for instance. So, let's just skip it.

test: allow choosing a wait function using the PSYCOPG_WAIT_FUNC env var

We won't make this public yet, possibly we never will (I think we are
the people responsible for this choice), but it might be useful for
testing.

perf(c): use poll() instead of select() for waiting, where available

fix(c): guard select() from high number file descriptors

The Python `select.select()` wrapper raises ValueError. Without a guard,
the C `wait_select()` segfaults. The C way to say you have been naughty.

On Windows this seems not only not needed, but it actually stops from creating
any connection at all.

fix(c): allow wait_select() to be interrupted by signals

fix(c): fix import on Windows

perf(c): add C version of select waiting function

'Wait' and 'Ready' enums moved into the '_enums' module to avoid a
circular import.

perf: use wait_select() as even if kqueue is the default

There is a bit less overhead using this simpler function than using
wait_selector.

test: add test on wait_select

Refactor tests to make a better use of pytest parametrization and skip
conditions.

perf: use wait_select on Windows

On windows, the default selector strategy is select. As a consequence
using the higher level selector object comes with a performance penalty.

feat: add wait_select() function

A few tests show that using select() from Python has a lower overhead.
See #414.

Use this function wherever defined and epoll() is the default select
strategy instead. This is mostly a draft to figure out where this
strategy can be used with success.

test: add simple test to compare performances in refactoring

This test is inspired to the problem open in #411, and is pretty much a
simple operation in a tight loop. It is used, at the moment, to compare
different ways to test I/O completion strategies with simple and fast
queries under no concurrency.

chore: declare Copy.read to return a buffer object

We still return memoryview, but leave the possibility open to return
something different, such as bytes.

fix: add C Float4 dumper

It would be used when looked up by oid. At the moment there is only a
Python version for it.

lint(c): avoid types warning building on Windows

Merge branch 'array-speedup'

docs: add a note about further optimizing text array loading

perf(c/array): cache the scratch area in the dumper

perf(c/array): cache the element loader in the array loader

docs: report array speedup in the news

perf(c/array): add C implementation of array loader

With this change we get to load an array without the transformer calling
any Python code (if the element loader is a CLoader as well).

We don't need to subclass the binary loader anymore because all the
required info is now taken from the loaded data. As a consequence, we
don't need a BaseArrayLoader anymore.

perf(c/array): reuse buffer to unescape array tokens

Save a malloc and setting up an exception per element, replaced by
realloc when needed and a single exception per array.

fix(c/array): null-terminate strings in text array loading