salvus.flow.acta.store.tiered
salvus.flow.acta.store.tiered salvus flow acta store tiered Content stores ordered from nearest to farthest.
Reads copy verified objects into nearer tiers. Writes target the nearest tier; explicit promotion copies objects outward. Read failures skip a tier, except digest mismatches; write failures propagate.
Classes
TieredContentStore
TieredContentStoreclass TieredContentStore(salvus.flow.acta.store.base.ContentStoreBase):
def __init__(self, tiers: Sequence[ContentStoreBase]) -> None: ...Several content stores read as one, nearest first.
tiersSequence[ContentStoreBase] — The stores to stack, nearest first. At least one.
tiers tuple[ContentStoreBase, ...]
tiers tuple[ContentStoreBase, ...]Return the stacked stores, nearest first.
delete()
delete()def delete(self, digest: str) -> None: ...Remove the object stored under digest.
digeststr — A content digest.
delete_binding()
delete_binding()def delete_binding(self, key: str) -> None: ...Remove the binding for key, if there is one.
Leave the target object unchanged.
keystr — The key to unbind, 64 lowercase hex characters.
exists()
exists()def exists(self, digest: str) -> bool: ...Return True if an object with digest is present.
digeststr — A content digest.
fetch_bytes()
fetch_bytes()def fetch_bytes(self, digest: str) -> bytes: ...Return the raw bytes stored under digest.
digeststr — A content digest.
digest first if this backend’s verify_on_fetch is True.fetch_file()
fetch_file()def fetch_file(self, digest: str) -> pathlib.Path: ...Return a read-only local path to the object under digest.
Reuse a local file when verify_on_fetch is false. Otherwise fetch
bytes
under the verification policy and write a temporary file. Missing
objects
and verification errors propagate.
digeststr — A content digest.
0o444 for a temp copy.get_binding()
get_binding()def get_binding(self, key: str) -> str | None: ...Return the digest bound to key, or None if unbound.
keystr — The key to look up, 64 lowercase hex characters.
iter_bindings()
iter_bindings()def iter_bindings(self) -> Iterator[tuple[str, str]]: ...Yield every binding any reachable tier holds, deduplicated.
Prefer the nearest tier for duplicate keys. Skip tiers that cannot be listed.
iter_digests()
iter_digests()def iter_digests(self) -> Iterator[str]: ...Yield every digest any reachable tier holds, deduplicated.
modified_at()
modified_at()def modified_at(self, digest: str) -> datetime.datetime | None: ...Return the nearest tier’s write time for digest.
digeststr — A content digest.
promote()
promote()def promote(self, digests: Iterable[str]) -> None: ...Copy digests outward, to every tier that lacks them.
Copy descriptor payloads before descriptors. Write failures propagate.
digestsIterable[str] — The refs to push outward.
promote_binding()
promote_binding()def promote_binding(self, key: str, digest: str) -> None: ...Bind key outward, in every tier beyond the nearest.
Write failures propagate.
keystr — The key to bind, 64 lowercase hex characters.digeststr — The digest to bind it to.
put_binding()
put_binding()def put_binding(self, key: str, digest: str) -> None: ...Bind key to digest, replacing any existing binding.
Validate the key and digest format; the target object need not exist.
keystr — The key to bind, 64 lowercase hex characters.digeststr — The content digest to bind it to.
put_bytes()
put_bytes()def put_bytes(self, data: bytes) -> str: ...Store data and return its digest.
Verify existing objects and reuse them. Raise DigestMismatchError if
stored bytes differ from their digest.
databytes — The bytes to store.
data.put_file()
put_file()def put_file(self, path: pathlib.Path) -> str: ...Store the bytes of an existing file and return its digest.
Hash and stage the same chunks, then write through _write_file.
Verify and reuse an existing object.
pathpathlib.Path — Path to the file whose bytes should be stored.