Struct BundleReader 

pub struct BundleReader<'a> { /* private fields */ }

A parsed, integrity-checked view over a .hmc bundle’s bytes. Borrows the input; get/segment return slices into it (zero copy).

Implementations

impl<'a> BundleReader<'a>

pub fn parse(bytes: &'a [u8]) -> Result<Self, BundleError>

Parse and fully validate a bundle: magic, version, declared length, whole-file CRC, and every entry’s bounds. On success the payloads are known-good and in-bounds, so get/segment are total on valid keys.

pub fn entries(&self) -> &[BundleEntry]

The bundle’s entries (index order).

pub fn flags(&self) -> u16

Reserved format flags from the header (0 in v1; reserved for future use such as a signed/compressed-entry variant).

pub fn entry(&self, key: &str) -> Option<&BundleEntry>

The index record for key, if present.

pub fn get(&self, key: &str) -> Option<&'a [u8]>

A zero-copy slice of the intact embedded file for key. This slice is a byte-identical standalone .q42 / .10d / .p64 — hand it straight to that format’s reader.

pub fn segment( &self, key: &str, seg_offset: u64, seg_len: u64, ) -> Option<&'a [u8]>

A zero-copy slice of an interior segment of an entry ([seg_offset .. seg_offset+seg_len) within the embedded file). Returns None if the key is unknown or the segment runs past the entry — proving the bundle does not interfere with segment-level access into an entry.

pub fn verify_entry(&self, key: &str) -> bool

Verify one entry’s payload against its recorded SHA-256.