identifiers: Rename some functions and types related to SWHIDs
When Software Heritage persistent identifiers were introduced, they were not yet abbreviated as SWHIDs.
Now that abbreviation is growing adoption, rename some functions and types in
swh.model.identifiers
for consistency:
-
PersistentId
->SWHID
-
persistent_identifier
->swhid
-
parse_persistent_identifier
->parse_swhid
Backward compatibility with previous naming is maintained but deprecation warnings are introduced to encourage the use of the new names.
Numerous variables in swh.model
codebase have also been renamed accordingly.
Also rework and improve documentation.
Migrated from D3412 (view on Phabricator)