Local snapshots

Immutable local snapshot payloads and explicit stored-byte validation.

class pipewhy.snapshots.LocalSnapshotStore(root)

Publish on a local filesystem; preserve failed attempts for explicit inspection.

Parameters:

root (str | Path)

class pipewhy.snapshots.SnapshotMetadata(snapshot_id: str, source_namespace: str, source_version: str, source_consistency: str, scope: str, started_at_ns: int, finished_at_ns: int, context: pipewhy.fingerprint.records.FingerprintContext, resolution: str, coverage: str, expected_records: int | None, returned_records: int, failures: tuple[str, ...] = (), parent_id: str | None = None)

Parameters:

• snapshot_id (str)

• source_namespace (str)

• source_version (str)

• source_consistency (str)

• scope (str)

• started_at_ns (int)

• finished_at_ns (int)

• context (FingerprintContext)

• resolution (str)

• coverage (str)

• expected_records (int | None)

• returned_records (int)

• failures (tuple[str, ...])

• parent_id (str | None)

exception pipewhy.snapshots.StorageIntegrityError

Stored bytes failed a declared size or checksum check.