docs: document measurement sync clone and pin

This commit is contained in:
Abdessamad Derraz committed 2026-10-27 09:02:28 +01:00
1 parent 11a4698e06
commit 7fa8d2d019
2 files changed
+3 -2

No files matched your search

+2 -2
View File
@@ -158,7 +158,7 @@ def seal(slim: dict, sidecar: dict, rid: str | None = None) -> tuple[dict, bytes
"""The slim record with its data reference and id, and the sidecar bytes. """The slim record with its data reference and id, and the sidecar bytes.
``rid`` keeps an id given before (a record carried over from the first ``rid`` keeps an id given before (a record carried over from the first
layout); otherwise the id is computed. layout), otherwise the id is computed.
""" """
blob = sidecar_bytes(sidecar) blob = sidecar_bytes(sidecar)
sealed = {**slim, "data": {"sha256": sha256_hex(blob), "bytes": len(blob)}} sealed = {**slim, "data": {"sha256": sha256_hex(blob), "bytes": len(blob)}}
@@ -229,7 +229,7 @@ def parse_lines(text: str, label: str) -> list[dict]:
def appended_only(before: str, after: str) -> str | None: def appended_only(before: str, after: str) -> str | None:
"""None when ``after`` keeps every line of ``before``, in place, and """None when ``after`` keeps every line of ``before``, in place, and
only adds lines at its end; otherwise the first line that moved.""" only adds lines at its end, otherwise the first line that moved."""
old, new = before.splitlines(), after.splitlines() old, new = before.splitlines(), after.splitlines()
for number, line in enumerate(old, 1): for number, line in enumerate(old, 1):
if number > len(new): if number > len(new):
+1
View File
@@ -793,6 +793,7 @@ python scripts/sync_measurements.py --fetch # clone or update, check t
python scripts/sync_measurements.py --fetch --bump # then move the pin to its head python scripts/sync_measurements.py --fetch --bump # then move the pin to its head
python scripts/sync_measurements.py --check-only # check every line and sidecar at the pin python scripts/sync_measurements.py --check-only # check every line and sidecar at the pin
python scripts/sync_measurements.py # write the site's measurement files python scripts/sync_measurements.py # write the site's measurement files
python scripts/sync_measurements.py --clone DIR --pin FILE # another clone or pin file
``` ```
`--fetch` is the only step on the network. It refuses a remote whose history `--fetch` is the only step on the network. It refuses a remote whose history