Struct Hdf5File 

pub struct Hdf5File {
    pub filename: String,
    pub root: Hdf5Group,
    pub superblock: Hdf5Superblock,
    pub named_types: NamedDatatypeRegistry,
    pub lock_state: LockState,
    pub parallel_meta: Option<ParallelHdf5Meta>,
    pub write_tick: u64,
}

Top-level HDF5 mock file containing a group hierarchy, named-type registry and file-level metadata.

Fields

filename: String

Virtual filename.

root: Hdf5Group

Root group (“/”).

superblock: Hdf5Superblock

Simulated superblock.

named_types: NamedDatatypeRegistry

Named (committed) datatype registry.

lock_state: LockState

Current file lock state.

parallel_meta: Option<ParallelHdf5Meta>

Optional parallel write metadata.

write_tick: u64

Simulation clock tick (incremented on each write).

Implementations

impl Hdf5File

pub fn new(filename: &str) -> Self

Create a new empty in-memory HDF5 file.

pub fn lock_write(&mut self, owner_id: u64) -> Hdf5Result<()>

Acquire an exclusive write lock (simulated).

Returns Err(Hdf5Error::FileLocked) if the file is already locked.

pub fn unlock(&mut self)

Release the write lock.

pub fn lock_read(&mut self) -> Hdf5Result<()>

Acquire a shared read lock (multiple readers allowed).

pub fn is_locked(&self) -> bool

Return true if the file is write-locked.

pub fn update_eof(&mut self, new_eof: u64)

Simulate updating the superblock’s EOF address after a write.

pub fn create_group(&mut self, path: &str) -> Hdf5Result<()>

Create a group at the given slash-separated path (relative to root).

Intermediate groups are created as needed (like mkdir -p).

pub fn open_group(&self, path: &str) -> Hdf5Result<&Hdf5Group>

Return a shared reference to the group at path.

pub fn open_group_mut(&mut self, path: &str) -> Hdf5Result<&mut Hdf5Group>

Return a mutable reference to the group at path.

pub fn create_dataset( &mut self, group_path: &str, name: &str, shape: Vec<usize>, dtype: Hdf5Dtype, ) -> Hdf5Result<()>

Create a dataset at group_path/dataset_name.

pub fn open_dataset( &self, group_path: &str, name: &str, ) -> Hdf5Result<&Hdf5Dataset>

Return a shared reference to a dataset at group_path/dataset_name.

pub fn open_dataset_mut( &mut self, group_path: &str, name: &str, ) -> Hdf5Result<&mut Hdf5Dataset>

Return a mutable reference to a dataset.

pub fn set_dataset_attr( &mut self, group_path: &str, dataset: &str, attr_name: &str, value: AttrValue, ) -> Hdf5Result<()>

Set an attribute on a dataset.

pub fn get_dataset_attr( &self, group_path: &str, dataset: &str, attr_name: &str, ) -> Hdf5Result<&AttrValue>

Get an attribute from a dataset.

pub fn commit_datatype( &mut self, name: &str, dtype: Hdf5Dtype, ) -> Hdf5Result<()>

Register a named (committed) datatype.

pub fn find_named_type(&self, name: &str) -> Hdf5Result<&Hdf5Dtype>

Look up a named datatype.

pub fn create_soft_link( &mut self, group_path: &str, link_name: &str, target: &str, ) -> Hdf5Result<()>

Create a soft link inside group_path.

pub fn create_hard_link( &mut self, group_path: &str, link_name: &str, target: &str, ) -> Hdf5Result<()>

Create a hard link inside group_path.

pub fn init_parallel(&mut self, n_ranks: usize)

Attach parallel HDF5 metadata for an N-rank job.

pub fn record_rank_bytes(&mut self, rank: usize, bytes: u64)

Record bytes written by MPI rank rank.

Trait Implementations

impl Clone for Hdf5File

fn clone(&self) -> Hdf5File

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Hdf5File

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.