They will be used by loaders, so they can deal only with
model objects, instead of having to do the same conversion themselves.

This removes the `data` and `save_path` arguments of `from_file` and
`from_disk`, as data loading is always deferred from now on.
To access it, users are now expected to either open the data files
themselves, or us `.to_model().with_data()`.

Regular files were created, as the 'mode' argument of os.mknod was missing.
However, creating devices requires root; so we can't reasonably do that in
tests.

Instead, we're using /dev/null instead of creating one.
And while we're at it, let's also use /dev/zero (which, if not handled
properly, will result in an infinite read).

It should be cheap enough to do it, and it makes tests easier.

It will be useful to loaders, as they currently load the entire
content in memory before deciding to skip it.

This allows the `swh identify` command to work again.

Close T2288

Can be useful to deduplicate code in swh-storage.

It already is in practice.

The current postgresql model refuses NULL values.

Related to P589

This allows for example to type:

  curl -s https://archive.softwareheritage.org/browse/content/sha1_git:64582b78792cd6c2d67d35da5a11bb80886a6409/raw/ | swh identify
  swh:1:cnt:64582b78792cd6c2d67d35da5a11bb80886a6409	-

Related to T2188

Add support to automatically compute identifier in the following object models:
Directory, Release, Revision, Snapshot.

If the identifier is not provided as parameter, it will be computed when the model
is initialized.

Allows us to call tests on things other than python3, with the same settings.

they will remain for internal use only, so should not be mentioned in this
public spec

this reverts the documentation part of 67fade5f

currently provides mainly 2 generators:
- gen_origins()
- gen_contents()

we do not really need them to be mutable, plus we gain their instances now
being hashable, so we can add them in set() for example.

Instead of relying on attr.asdict recursion, we do recursion ourselves. This
simplifies a lot of the inherited to_dict() methods.

Related D2082

Daniele Serafini authored 5 years ago and Stefano Zacchiroli committed 5 years ago

... from test_persistent_identifier.

Closes T1986

It is now possible to install swh-model without dulwich (and Click, FWIW).

Users who want to use "swh identify" should "pip install swh-model[cli]".