1 data_handling.store_identity

data_handling.store_identity

Replacement-sensitive store identity from bounded filesystem metadata.

This owner captures paths, aliases, stat metadata and authoritative versions; it never imports dataset composition, training, readers or array payloads. Bundle-named identity records retain their established cache/hash contract.

1.1 Attributes

Name Description
AuthoritativeFieldStatus Parse state of one bounded authoritative JSON field.
GenerationEntryStatus Resolution state of one selected filesystem entry.

1.2 Classes

Name Description
DatasetBundleAuthoritativeField One separately parsed seal or version used by generation identity.
DatasetBundleEntryFingerprint Bounded selected-entry and authoritative-metadata identity.
DatasetBundleGeneration Versioned replacement-sensitive identity for one selected bundle.
DatasetBundleGenerationChangedError Raised when selected bundle entries change during acquisition.
DatasetBundleSelection Session-local selection of one VIN root and explicit rollout stores.

1.2.1 DatasetBundleAuthoritativeField

data_handling.store_identity.DatasetBundleAuthoritativeField(
    relative_name,
    field_name,
    status,
    value,
)

One separately parsed seal or version used by generation identity.

1.2.2 DatasetBundleEntryFingerprint

data_handling.store_identity.DatasetBundleEntryFingerprint(
    selected_entry,
    entry_status,
    entry_kind,
    symlink_target,
    inode,
    ctime_ns,
    mtime_ns,
    size,
    canonical_target,
    metadata,
    authoritative_fields,
)

Bounded selected-entry and authoritative-metadata identity.

1.2.3 DatasetBundleGeneration

data_handling.store_identity.DatasetBundleGeneration(
    identity_version,
    root,
    rollouts,
    generation_digest,
)

Versioned replacement-sensitive identity for one selected bundle.

1.2.4 DatasetBundleGenerationChangedError

data_handling.store_identity.DatasetBundleGenerationChangedError(
    expected,
    observed,
)

Raised when selected bundle entries change during acquisition.

1.2.5 DatasetBundleSelection

data_handling.store_identity.DatasetBundleSelection(
    root_store,
    rollout_stores=(),
)

Session-local selection of one VIN root and explicit rollout stores.

1.2.5.1 Attributes

Name Description
root_store Exactly one immutable VIN offline-store directory.
rollout_stores Explicit rollout-store directories; order is normalized and deduplicated.

1.3 Functions

Name Description
absolute_store_entry Normalize a selected entry without resolving its observable alias.
assert_dataset_bundle_generation_current Raise when any selected entry or bounded authoritative metadata changed.
capture_dataset_bundle_generation Capture selected entries before resolving the canonical bundle selection.
capture_store_entry Capture one alias-sensitive store entry using owner-defined metadata.
read_store_metadata Read bounded regular JSON metadata with explicit unavailable status.
store_entry_fingerprint_json Serialize a captured store entry with the canonical generation layout.

1.3.1 absolute_store_entry

data_handling.store_identity.absolute_store_entry(path)

Normalize a selected entry without resolving its observable alias.

1.3.2 assert_dataset_bundle_generation_current

data_handling.store_identity.assert_dataset_bundle_generation_current(
    generation,
)

Raise when any selected entry or bounded authoritative metadata changed.

1.3.3 capture_dataset_bundle_generation

data_handling.store_identity.capture_dataset_bundle_generation(
    root_entry,
    rollout_entries,
)

Capture selected entries before resolving the canonical bundle selection.

The bounded fingerprint includes selected-entry lstat identity and only authoritative root metadata. Payload chunks are never enumerated. Rollout membership is canonicalized by absolute selected-entry path because its input order has no scientific meaning.

1.3.4 capture_store_entry

data_handling.store_identity.capture_store_entry(path, *, kind)

Capture one alias-sensitive store entry using owner-defined metadata.

Callers choose the store kind, never authoritative-field constants or fingerprint serialization mechanics. No arrays or readers are opened.

1.3.5 read_store_metadata

data_handling.store_identity.read_store_metadata(path)

Read bounded regular JSON metadata with explicit unavailable status.

1.3.6 store_entry_fingerprint_json

data_handling.store_identity.store_entry_fingerprint_json(entry)

Serialize a captured store entry with the canonical generation layout.

Back to top