1 rollouts.candidate_support.bundle_io

rollouts.candidate_support.bundle_io

Content-addressed candidate benchmark bundle serialization and validation.

1.1 Classes

Name	Description
CandidateBenchmarkBundle	Validated immutable benchmark facts and their durable source identity.
CandidateBenchmarkSource	Durable identity of a validated benchmark representation.

1.1.1 CandidateBenchmarkBundle

rollouts.candidate_support.bundle_io.CandidateBenchmarkBundle(
    manifest,
    records,
    source,
)

Validated immutable benchmark facts and their durable source identity.

1.1.2 CandidateBenchmarkSource

rollouts.candidate_support.bundle_io.CandidateBenchmarkSource(
    kind,
    sha256,
    path=None,
)

Durable identity of a validated benchmark representation.

1.1.2.1 Attributes

Name	Type	Description
kind	Literal['directory', 'archive-bytes']	`directory` for a persisted bundle or `archive-bytes` for an in-memory ZIP payload.
sha256	str	Content identity of the exact source representation.
path	Path \| None	Canonical persisted directory for `directory` sources; absent for archive bytes, which have no durable filesystem location.

1.2 Functions

Name	Description
benchmark_binding_from_manifest	Derive a non-sentinel immutable binding from the canonical store manifest.
benchmark_binding_from_reader	Derive bindings from a validated reader and its promoted store seal.
read_bundle	Read and validate exactly one complete, current, hash-bound bundle.
read_bundle_bytes	Validate canonical ZIP bytes without fabricating a temporary path.
serialize_bundle_bytes	Produce deterministic bundle bytes through the same canonical writer.
write_bundle	Atomically write a deterministic JSON/Parquet evidence bundle.

1.2.1 benchmark_binding_from_manifest

rollouts.candidate_support.bundle_io.benchmark_binding_from_manifest(
    manifest_payload,
)

Derive a non-sentinel immutable binding from the canonical store manifest.

1.2.2 benchmark_binding_from_reader

rollouts.candidate_support.bundle_io.benchmark_binding_from_reader(
    reader,
    manifest_payload=None,
)

Derive bindings from a validated reader and its promoted store seal.

1.2.3 read_bundle

rollouts.candidate_support.bundle_io.read_bundle(path, *, expected_binding)

Read and validate exactly one complete, current, hash-bound bundle.

1.2.4 read_bundle_bytes

rollouts.candidate_support.bundle_io.read_bundle_bytes(
    payload,
    *,
    expected_binding,
)

Validate canonical ZIP bytes without fabricating a temporary path.

1.2.5 serialize_bundle_bytes

rollouts.candidate_support.bundle_io.serialize_bundle_bytes(
    records,
    *,
    provenance,
)

Produce deterministic bundle bytes through the same canonical writer.

1.2.6 write_bundle

rollouts.candidate_support.bundle_io.write_bundle(
    path,
    records,
    *,
    provenance=None,
)

Atomically write a deterministic JSON/Parquet evidence bundle.

# rollouts.candidate_support.bundle_io { #aria_nbv.rollouts.candidate_support.bundle_io } `rollouts.candidate_support.bundle_io` Content-addressed candidate benchmark bundle serialization and validation. ## Classes | Name | Description | | --- | --- | | [CandidateBenchmarkBundle](#aria_nbv.rollouts.candidate_support.bundle_io.CandidateBenchmarkBundle) | Validated immutable benchmark facts and their durable source identity. | | [CandidateBenchmarkSource](#aria_nbv.rollouts.candidate_support.bundle_io.CandidateBenchmarkSource) | Durable identity of a validated benchmark representation. | ### CandidateBenchmarkBundle { #aria_nbv.rollouts.candidate_support.bundle_io.CandidateBenchmarkBundle } ```python rollouts.candidate_support.bundle_io.CandidateBenchmarkBundle( manifest, records, source, ) ``` Validated immutable benchmark facts and their durable source identity. ### CandidateBenchmarkSource { #aria_nbv.rollouts.candidate_support.bundle_io.CandidateBenchmarkSource } ```python rollouts.candidate_support.bundle_io.CandidateBenchmarkSource( kind, sha256, path=None, ) ``` Durable identity of a validated benchmark representation. #### Attributes {.doc-section .doc-section-attributes} | Name | Type | Description | |--------|-----------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------| | kind | [Literal](`typing.Literal`)\[\'directory\', \'archive-bytes\'\] | ``directory`` for a persisted bundle or ``archive-bytes`` for an in-memory ZIP payload. | | sha256 | [str](`str`) | Content identity of the exact source representation. | | path | [Path](`pathlib.Path`) \| None | Canonical persisted directory for ``directory`` sources; absent for archive bytes, which have no durable filesystem location. | ## Functions | Name | Description | | --- | --- | | [benchmark_binding_from_manifest](#aria_nbv.rollouts.candidate_support.bundle_io.benchmark_binding_from_manifest) | Derive a non-sentinel immutable binding from the canonical store manifest. | | [benchmark_binding_from_reader](#aria_nbv.rollouts.candidate_support.bundle_io.benchmark_binding_from_reader) | Derive bindings from a validated reader and its promoted store seal. | | [read_bundle](#aria_nbv.rollouts.candidate_support.bundle_io.read_bundle) | Read and validate exactly one complete, current, hash-bound bundle. | | [read_bundle_bytes](#aria_nbv.rollouts.candidate_support.bundle_io.read_bundle_bytes) | Validate canonical ZIP bytes without fabricating a temporary path. | | [serialize_bundle_bytes](#aria_nbv.rollouts.candidate_support.bundle_io.serialize_bundle_bytes) | Produce deterministic bundle bytes through the same canonical writer. | | [write_bundle](#aria_nbv.rollouts.candidate_support.bundle_io.write_bundle) | Atomically write a deterministic JSON/Parquet evidence bundle. | ### benchmark_binding_from_manifest { #aria_nbv.rollouts.candidate_support.bundle_io.benchmark_binding_from_manifest } ```python rollouts.candidate_support.bundle_io.benchmark_binding_from_manifest( manifest_payload, ) ``` Derive a non-sentinel immutable binding from the canonical store manifest. ### benchmark_binding_from_reader { #aria_nbv.rollouts.candidate_support.bundle_io.benchmark_binding_from_reader } ```python rollouts.candidate_support.bundle_io.benchmark_binding_from_reader( reader, manifest_payload=None, ) ``` Derive bindings from a validated reader and its promoted store seal. ### read_bundle { #aria_nbv.rollouts.candidate_support.bundle_io.read_bundle } ```python rollouts.candidate_support.bundle_io.read_bundle(path, *, expected_binding) ``` Read and validate exactly one complete, current, hash-bound bundle. ### read_bundle_bytes { #aria_nbv.rollouts.candidate_support.bundle_io.read_bundle_bytes } ```python rollouts.candidate_support.bundle_io.read_bundle_bytes( payload, *, expected_binding, ) ``` Validate canonical ZIP bytes without fabricating a temporary path. ### serialize_bundle_bytes { #aria_nbv.rollouts.candidate_support.bundle_io.serialize_bundle_bytes } ```python rollouts.candidate_support.bundle_io.serialize_bundle_bytes( records, *, provenance, ) ``` Produce deterministic bundle bytes through the same canonical writer. ### write_bundle { #aria_nbv.rollouts.candidate_support.bundle_io.write_bundle } ```python rollouts.candidate_support.bundle_io.write_bundle( path, records, *, provenance=None, ) ``` Atomically write a deterministic JSON/Parquet evidence bundle.