Module layout 

Coverage on-disk layout helpers.

These helpers define:

• how coverage ids are validated
• how coverage sidecar keys are constructed (relative to the table root)
• deterministic id derivation helpers for per-segment and table snapshots

Note: these functions return canonical slash-separated object keys. The storage backend is responsible for resolving them under its table root.

Enums

CoverageLayoutError

Errors that can occur during coverage layout operations.

Constants

COVERAGE_EXT

File extension for coverage files.

COVERAGE_ROOT_DIR

Root directory for coverage data.

SEGMENT_COVERAGE_DIR

Directory for segment coverage data.

TABLE_SNAPSHOT_DIR

Directory for table snapshot coverage data.

Functions

segment_coverage_id_v2

Deterministically derive a safe content id for segment coverage.

segment_coverage_key

Relative object key: _coverage/segments/<coverage_id>.roar

table_coverage_id_v2

Deterministically derive a safe content id for table snapshot coverage.

table_snapshot_key

Relative object key: _coverage/table/<version>-<snapshot_id>.roar

validate_coverage_id

Validates that a coverage ID meets security and format requirements.