1 datasets.bundles.inspection

datasets.bundles.inspection

Read-only lightweight cross-store bundle evidence and discovery.

1.1 Attributes

Name Description
DatasetBundleVerdict Training-bundle readiness after the requested level of inspection.
FindingSeverity Effect of one bundle finding on the aggregate readiness verdict.

1.2 Classes

Name Description
DatasetBundleDiscovery Bounded filenames-only candidates for the Training Dataset page.
DatasetBundleEvidence Deterministic lightweight evidence for one selected training bundle.
DatasetBundleFinding One exact readiness or provenance finding for a selected store.
DatasetBundleSummaryRequest Complete cache request for lightweight or validated bundle evidence.

1.2.1 DatasetBundleDiscovery

datasets.bundles.inspection.DatasetBundleDiscovery(root_stores, rollout_stores)

Bounded filenames-only candidates for the Training Dataset page.

1.2.2 DatasetBundleEvidence

datasets.bundles.inspection.DatasetBundleEvidence(
    selection,
    generation,
    verdict,
    root,
    rollouts,
    aggregate,
    topology,
    coral_artifacts,
    findings,
)

Deterministic lightweight evidence for one selected training bundle.

1.2.2.1 Attributes

Name Description
selection Normalized root and rollout selection.
generation Selected-entry and canonical-target attribution for this acquisition.
verdict Strict readiness verdict derived from findings.
root VIN manifest, index, split, schema, and storage summary.
rollouts All selected rollout summaries, including incompatible stores.
aggregate Totals over compatible stores only; unavailable values remain None.
topology Compact root-to-rollout dependency nodes and classified edges.
coral_artifacts Optional CORAL binner artifacts; missing provenance never blocks readiness.
findings Ordered evidence underlying verdict.

1.2.2.2 Methods

Name Description
to_jsonable Return the complete download-ready evidence payload.
1.2.2.2.1 to_jsonable
datasets.bundles.inspection.DatasetBundleEvidence.to_jsonable()

Return the complete download-ready evidence payload.

1.2.3 DatasetBundleFinding

datasets.bundles.inspection.DatasetBundleFinding(
    severity,
    code,
    message,
    store_path=None,
)

One exact readiness or provenance finding for a selected store.

1.2.3.1 Attributes

Name Description
severity Whether the finding blocks, leaves evidence incomplete, or only informs.
code Stable machine-readable reason code.
message Concise operator-facing explanation.
store_path Affected store, or None for a bundle-level finding.

1.2.3.2 Methods

Name Description
to_jsonable Return a JSON-compatible finding row.
1.2.3.2.1 to_jsonable
datasets.bundles.inspection.DatasetBundleFinding.to_jsonable()

Return a JSON-compatible finding row.

1.2.4 DatasetBundleSummaryRequest

datasets.bundles.inspection.DatasetBundleSummaryRequest(
    selection,
    generation,
    coral_artifact_roots=(),
    validate_rollouts=False,
)

Complete cache request for lightweight or validated bundle evidence.

1.3 Functions

Name Description
build_dataset_bundle_summary Inspect one root-plus-rollout bundle without scanning analytic arrays.
discover_dataset_bundle_candidates Discover filenames-only root and rollout candidates below cache_root.
inspect_dataset_bundle Acquire frozen bundle evidence against one complete generation-bound request.

1.3.1 build_dataset_bundle_summary

datasets.bundles.inspection.build_dataset_bundle_summary(
    selection,
    *,
    coral_artifact_roots=(),
    validate_rollouts=False,
)

Inspect one root-plus-rollout bundle without scanning analytic arrays.

1.3.1.1 Parameters

Name Type Description Default
selection DatasetBundleSelection Session-local bundle selection. required
coral_artifact_roots tuple[Path, …] Files or directories searched for fitted rri_binner*.json artifacts. ()
validate_rollouts bool Run each rollout store’s full read-only validator. When false, selected compatible stores keep the verdict Incomplete until validation is explicitly requested. False

1.3.1.2 Returns

Name Type Description
DatasetBundleEvidence Download-ready bundle evidence. Incompatible rollout stores remain in
DatasetBundleEvidence rollouts but are excluded from aggregate training totals.

1.3.2 discover_dataset_bundle_candidates

datasets.bundles.inspection.discover_dataset_bundle_candidates(cache_root)

Discover filenames-only root and rollout candidates below cache_root.

1.3.3 inspect_dataset_bundle

datasets.bundles.inspection.inspect_dataset_bundle(request)

Acquire frozen bundle evidence against one complete generation-bound request.

Back to top