Add Alpine support to `wheel_linux_before_all.sh` script

Update cibuildwheel to v2.2.2

The v2.2.x version of cibuildwheel adds supports for building
`musllinux`[^1] wheels. Meaning Alpine users can finally take advantage
of binary installations.

[^1]: https://www.python.org/dev/peps/pep-0656/

Expose the C package version in the _cmodule module

"Expose" just to say: this interface remains internal. But it's handy
for development and testing nonetheless.

Allow to run typing tests from an arbitrary location

Include typing information in psycopg-binary distribution

Merge branch 'wheel-strip' into packaging-love

Mention binary package size reduction in changelog

Install the zip command in the cibuildwheel image

Required to unpack the wheel archive and strip symbols.

Strip only psycopg dynamic libraries, not the system ones

Stripping symbols is beneficial (reduction of 30% of the final package, > %90%
of the installed libraries. However just running `auditwheel repair --strip`
breaks some of the libraries included from the system, which fail at import
with errors such as "ELF load command address/offset not properly aligned".

Strip debug symbols from wheel packages

Close #142

Bump to next dev release

Add Generic Counter and Deque to compat module

Set version number to 3.0.2

Merge branch 'mypy-tests/scripts'

Let mypy check tests/scripts code

Make spiketest.py script mypy-clean

- allow untyped defs/calls (as everywhere else in tests/*)
- avoid list comprehension filled with no value
- add a type variable to Connection subclass
- drop useless sys.exit() call, since main() does not return a value

Add a type hint for main() in dectest's scripts

Allow Iterable type for cursor.executemany() parameters

An iterable is enough since we only iterate over the parameters value
using a for loop (in _executemany_gen()).

There's an usage with a generator expression in
tests/scripts/dectest.py. (Spotted by running mypy.)

Merge branch 'mypy-tests/pool'

Let mypy check tests/pool code

Ignore mypy errors about cursor.fetchone()

fetchone() can return None, so mypy complains that '"None" object is
not iterable' (or not indexable).

Use the correct connection class in test_pool_async.py::test_putconn_no_pool()

Declare type variable for Counter in pool tests

We use the comment-style for type annotation because collections.Counter
is generic only since Python 3.9.

Declare types for dynamically populated lists in pool tests

Add required type variable to (Async)Connection in pool tests

Avoid unassigned list comprehensions in pool tests

Mypy complains that Thread.start()/join() does not return a value.

Use setattr() when monkeypatching in pool tests

This is to avoid mypy error: Cannot assign to a method.

Make tests/pool a Python package

Otherwise, per-module mypy configuration does not apply (and we, e.g.,
get error about "no-untyped-defs").

Merge branch 'mypy-tests/dbapi20'

Make dbapi20 tests mypy-clean

Catch only expected exception in test_psycopg_dbapi20.py::test_connect_args()

Drop duplicated test_nextset() method of DatabaseAPI20Test

Spotted by mypy:

  error: Name "test_nextset" already defined on line 742

Merge branch 'mypy-tests/test_sql'

Let mypy check tests/test_sql.py

Fix type of re.sub() call in sql tests

All values of re.sub() must be of the type, here bytes.

Let mypy ignore expected type errors in sql tests

Work around a mypy 'Incompatible types in assignment' in sql tests

By defining 'obj' as a Composed value, we avoid the mypy error about
variable type change.

Merge branch 'mypy-tests/pq'

Let mypy check tests/pq code

Let mypy ignore an expected type error in pq tests

Adjust test_pgconn::test_info() for mypy

Resolves the following error:
  error: Item "None" of "Optional[bytes]" has no attribute "decode"

Rename a variable in test_conninfo_parse()

To silent a 'incompatible types in assignment' mypy error.

Rename a variable in tests/pq/test_copy.py

To silent a 'incompatible types in assignment' mypy error.

Adjust test_pq::test_build_version() for mypy

pq.__build_version__ might be None.

Rename a variable in test_conninfo_parse() to silent a mypy error

Merge branch 'mypy-tests/types'

Let mypy check tests/types code

We configure mypy to check untyped defs in tests/ directory, but only
let it check tests/types files at the moment.

Rename a variable in test_composite.py::test_register_scope()

To make mypy happy.

Add a couple of "# type: ignore" in datetime tests

Mypy cannot check map() calls on split-strings.

Rename a variable in test_array.py::test_all_chars()

To make mypy happy.

Make test_multirange.py mypy-clean

Either ignoring errors (often intended) or adding type hints/ignore as
in previous commit.

Make test_range.py mypy-clean

This consists in adding the type variable to Range type when it makes
sense or to let mypy ignore the 'var-annotated' error for ranges
declared as empty, and where we do not use the underlying value.

In test_in(), we add an extra check to verify that mypy warns about
types incompatibility.

Ignore typing errors in test_no_info_error() tests

Pass a dummy oid in test_hstore::test_parse_{ok,bad}

HstoreLoader() wants an integer value as first parameter 'oid'. In these
tests, the value does not matter but at least pass the expected type.

Make __version__ importable, although not included in __all__

Make the mypy fixture available to the whole test suite

Also make mypy tests automatically slow.

See #130 for other cases where a mypy fixture would be useful.

Harmless refactoring to server-side cursors

It's cool that mypy finds the common base of the two expressions in the
ternary operator.

Shorten server-side cursor execute() tracebacks

Merge remote-tracking branch 'sureshdsk/issue-125'

Ignore .venv dir in any subdir

added async server cursor close tests for fetchone, fetchmany, fetchall

fixed cursor close check + updated news

added issue-125 fix to news

Fix Sphinx setup version specification

Also specify other dependencies using the ~= operator.

added async cursor close tests for fetchone, fetchmany, fetchall

fixed cursor close check + added tests for fetchone, fetchmany, fetchall

fix: check if cursor is closed

Fix test range comparison with empty ranges

Mark slow every test taking more than 0.1s to run

Better workaround for bad datetime comparison Python bug

The problem doesn't just happen far away in the future. 2255 is enough.
See https://bugs.python.org/issue45347#msg405284

Compare timestamps by checking if their delta is 0, convert ranges bounds
to utc.

Fun fact: pytest --randomly-seed=293472621 triggers both the multirange
array bug and this.

Avoid error in multirange arrays random testing

Don't create arrays with first element empty if dumping in binary. It is
known to not work (see xfail in multirange tests).

Retry a brittle test

Make ServerCursorHelper.format private

Reduce duplicate code, remove a race condition (the format set outside
the lock section), make _declare_gen() interface more similar to
_execute_gen().

refactor: compose DECLARE in the helper common path

...instead of in the separate sync/async branches.

Clean up imports/exports in psycopg package

Drop file-level F401 ignore and declare explicitly what is exported.

Something reordered to keep together package-level types registration,
to use a somewhat alphabetical order to group of things.

Rename test file dropping the 3 from psycopg

Raise a TypeError when slice-setting a Multirange with a non-iterable value

The type declaration is:

    def __setitem__(index: slice, value: Iterable[Range[T]]) -> None:
        ...

so passing a non-iterable value should not be allowed. However, the
method implementation makes a special-case for non-iterable values with
a slice.

In accordance with MutableSequence behavior, e.g.:

  >>> x = [1, 2, 3]
  >>> x[1:3] = 0
  Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
  TypeError: can only assign an iterable

it seems more correct to raise a TypeError.

Re-export DB-API type constructors and singletons

Following https://www.python.org/dev/peps/pep-0249/#type-objects-and-constructors

Fix formatting in news page

Fix type hint for `Connection.notifies()`

Close #128.

Fix type hint for `sql.SQL.join()`

Close #127.

Remove the pgresult structure from the cursor on close

This is what the dbapi demands and helps with make the cursor
unavailable after close.

Bump sphinx to 4.2 to build docs

Version 4.1 has problems with Python 3.10

Install shapely requirements to validate docs

If it works the same change will be applied to the psycopg-website
repos.

Close #123

Extend docs about connection context

Highlight the difference from normal connection (implicit rollback vs.
explicit commit) after conversation on the mailing list about the
inconsistency between the operations.

Fix wrong error message on unknown PostgreSQL encoding

Reported in #122.

Bump version number to next dev release

Fix var name in transactions doc examples

Highlight meaningful lines in transaction examples

Fix docs wording after Daniel Fortunov's suggestion

Tweak "Multiple statements in the same query" docs

Minor wording and typographical tweaks in follow-up to 650e215b

Add documentation about multiple statements execution

Close #109.

Improve transactions documentation

close #110

Bump to version 3.0.1

Merge branch 'bug-112'

Mention bug fixed in news file

Close #112.

Don't use row dumpers to dump a sequence in C implementation either

As per previous commit, the assumption that different rows will need the
different dumper is easily broken.

Ref. bug #112

Add tests on executemany to check the same problem of bug #112

Don't use row dumpers to dump a sequence

Using row dumpers uses the assumption that the types will be the same if
we see the same query. It's easy to break this assumption. Being cheeky
is a way (like passing arguments 1, '2' to the same query...) but it's
easy to trigger the problem dumping numbers and going from in2-size to
int4-size.

This commit only fixes the Python implementation.

Ref. bug #112

Add test to reproduce bug #112

Our first bug!