Skip to content
Snippets Groups Projects
Commit 41eb0679 authored by Antoine Lambert's avatar Antoine Lambert
Browse files

api/extid: Update documentation to mention some extid version bumps

Version of extids related to nix/guix were bumped to 1 after some issues
were detected in production after the first loadings batch.

Related to swh/infra/sysadm-environment#5222.
parent db9e2d9a
No related branches found
No related tags found
No related merge requests found
Pipeline #7284 passed
......@@ -117,7 +117,8 @@ def api_extid(request: Request, extid_type: str, extid_format: str, extid: str):
``hg id -r <rev_num> --template {hg_template}``.
`Guix <https://guix.gnu.org/manual/en/html_node/Invoking-guix-hash.html>`_ and
`Nix <https://nixos.wiki/wiki/Nix_Hash>`_ related:
`Nix <https://nixos.wiki/wiki/Nix_Hash>`_ related (must be queried with the
**extid_version** query parameter set to **1** to ensure correctness):
- ``nar-sha256``: sha256 checksum of a `Nix Archive (NAR)
<https://edolstra.github.io/pubs/phd-thesis.pdf#page=101>`_, used to deterministically
......@@ -154,9 +155,9 @@ def api_extid(request: Request, extid_type: str, extid_format: str, extid: str):
:swh_web_api:`extid/bzr-nodeid/raw:rodney.dawes@canonical.com-20090512192901-f22ja60nsgq9j5a4/`
:swh_web_api:`extid/hg-nodeid/hex:1ce49c60732c9020ce2f98d03a7a71ec8d5be191/`
:swh_web_api:`extid/checksum-sha256/base64url:s4lFKlaGmGiN2jiAIGg3ihbBXEr5sVPN2ZtlORKSu8c/`
:swh_web_api:`extid/nar-sha256/base64url:dPfSdTz-U7tD8GhrxwKg2S288XKOWPcVvz3y3jkplHI/`
:swh_web_api:`extid/checksum-sha512/base64url:AL5bxZ-gStT5UpzSc1dN-XVxxWN9FHtvBlZoFeFFMowwgMKWq9GLZHV8DWX-g7ugiKxlKa2ph2oTQCqvhixDQw/`
:swh_web_api:`extid/checksum-sha256/base64url:s4lFKlaGmGiN2jiAIGg3ihbBXEr5sVPN2ZtlORKSu8c/?extid_version=1`
:swh_web_api:`extid/nar-sha256/base64url:AAAlhKVqm86FeTUVYEKY-LOx6Ul-APxjYaDC5zHAY_M/?extid_version=1`
:swh_web_api:`extid/checksum-sha512/base64url:AL5bxZ-gStT5UpzSc1dN-XVxxWN9FHtvBlZoFeFFMowwgMKWq9GLZHV8DWX-g7ugiKxlKa2ph2oTQCqvhixDQw/?extid_version=1`
"""
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment