It allows other packages (eg. swh-graph) to depend on the presence of the local
dataset, with a configurable way to obtain it if missing

They are only useful while exporting the dataset -- after the export is
finished, meta.json is good enough and stamp files only save a couple
of minutes when only some objects types are needed (ie. never in practice)

This will allow running swh-graph tasks easily on machines that didn't
export the graph themselves.

Other tasks will import them in order to depend on tasks defined here

They are more tuned toward running automatically, as they call each
other as needed, and can be imported by workflows defined in other
modules (eg. the future swh.graph.luigi module).

So it can be reused by a Luigi task

For some reason, using a non-existing database works when working with
credentials with unnecessarily high privileges (though it is not clear
to me which permissions allow this).

Order was randomized since 4154d43a

- pre-commit from 4.1.0 to 4.3.0,
- codespell from 2.2.1 to 2.2.2,
- black from 22.3.0 to 22.10.0 and
- flake8 from 4.0.1 to 5.0.4. Also freeze flake8 dependencies.

Also change flake8's repo config to github (the gitlab mirror
being outdated).

* objstorage.add() now requires an id as second argument
* objstorage.get() now allows a dict of hashes instead of just
  sha1, and a future version will require this dict

We are removing support for the objstorage computing the object id itself.

Significantly improves performance by reducing the number of levels in
each DB, and thus reducing the amount of compaction.

Reviewers: #reviewers, olasd

Reviewed By: #reviewers, olasd

Subscribers: olasd

Differential Revision: https://forge.softwareheritage.org/D7711

We no longer support exporting the dataset as PostgreSQL dumps. It's
pretty much useless for big data analysis; we rather encourage
researchers to use big data engine (Hadoop, Hive, Presto...) which all
support the ORC format.

Alternatives to import the dataset on PostgreSQL include
https://github.com/HighgoSoftware/orc_fdw/ , or using the swh mirroring
pipeline to spawn a local storage instance with a PostgreSQL backend.

That hook can be frustrating as it can discard a long commit message
if it finds a typo in it so better removing it.

this option allows to restart consuming kafka a bit earlier than last
committed offsets.
This can be useful to test and debug.

to easily set the list of exported object types. If not set, export all
supported object types.

Note that ``--exclude`` is also applied.

The origin table now contains the origin URL and a sha1 of the URL as
the "ID" field. Allows us to join this table more easily with the SWHIDs
retrieved from the compressed graph, as well as generate the edge
dataset without having to compute sha1s manually.

Related to T3922

black is considered stable since release 22.1.0 and the version
we are currently using is quite outdated and not compatible with
click 8.1.0, so it is time to bump it to its latest stable release.

Please note that E501 pycodestyle warning related to line length
is replaced by B950 one from flake8-bugbear as recommended by black.
https://black.readthedocs.io/en/stable/the_black_code_style/current_style.html#line-length

Related to T3922

this feature requires a config parameter `with_data=true` and an objstorage
configuration.

pytest-postgresql 3.1.3 and pytest-redis 2.4.0 added support for
pytest >= 7 so we can now drop the pytest pinning.

Partially reverting 5a8a8a78.

This is needed to ensure better compliance with usual ORC semantics,
where one directory = one table.

- use shortened values in the progress bar (eg. '11.3M/566M' instead of
  something like '11310201/566123456')
- reduce the description strings and align them.

The result looks like:

Exporting release:
  - Offset: 100%|███████████████████████████████| 64/64 [00:03<00:00, 18.61it/s]
  - Export: 100%|█████████████████| 130/130 [00:01<00:00, 10.3it/s, workers=4/4]