rustyHDF5

use rustyhdf5::{File, FileBuilder, AttrValue};

// Write
let mut builder = FileBuilder::new();
builder.create_dataset("temperatures")
    .with_f64_data(&[22.5, 23.1, 21.8])
    .with_shape(&[3]);
builder.set_attr("version", AttrValue::I64(1));
builder.write("output.h5").unwrap();

// Read
let file = File::open("output.h5").unwrap();
let ds = file.dataset("temperatures").unwrap();
let values = ds.read_f64().unwrap();
assert_eq!(values, vec![22.5, 23.1, 21.8]);

use rustyhdf5_format::file_writer::{FileWriter, AttrValue};

let mut fw = FileWriter::new();
fw.create_dataset("data")
    .with_f64_data(&[1.0, 2.0, 3.0])
    .with_shape(&[3]);
let bytes = fw.finish().unwrap();
std::fs::write("output.h5", &bytes).unwrap();

use rustyhdf5_format::signature::find_signature;
use rustyhdf5_format::superblock::Superblock;
use rustyhdf5_format::object_header::ObjectHeader;
use rustyhdf5_format::group_v2::resolve_path_any;
use rustyhdf5_format::message_type::MessageType;
use rustyhdf5_format::dataspace::Dataspace;
use rustyhdf5_format::datatype::Datatype;
use rustyhdf5_format::data_layout::DataLayout;
use rustyhdf5_format::data_read::{read_raw_data, read_as_f64};

let file_data = std::fs::read("output.h5").unwrap();
let offset = find_signature(&file_data).unwrap();
let sb = Superblock::parse(&file_data, offset).unwrap();
let addr = resolve_path_any(&file_data, &sb, "data").unwrap();
let hdr = ObjectHeader::parse(&file_data, addr as usize, sb.offset_size, sb.length_size).unwrap();

let ds = Dataspace::parse(
    &hdr.messages.iter().find(|m| m.msg_type == MessageType::Dataspace).unwrap().data,
    sb.length_size,
).unwrap();
let (dt, _) = Datatype::parse(
    &hdr.messages.iter().find(|m| m.msg_type == MessageType::Datatype).unwrap().data,
).unwrap();
let layout = DataLayout::parse(
    &hdr.messages.iter().find(|m| m.msg_type == MessageType::DataLayout).unwrap().data,
    sb.offset_size, sb.length_size,
).unwrap();

let raw = read_raw_data(&file_data, &layout, &ds, &dt).unwrap();
let values = read_as_f64(&raw, &dt).unwrap();
assert_eq!(values, vec![1.0, 2.0, 3.0]);

use rustyhdf5_format::file_writer::FileWriter;

let mut fw = FileWriter::new();
let data: Vec<f64> = (0..1000).map(|i| i as f64).collect();
fw.create_dataset("data")
    .with_f64_data(&data)
    .with_shape(&[1000])
    .with_chunks(&[100])
    .with_shuffle()
    .with_deflate(6);
let bytes = fw.finish().unwrap();

use rustyhdf5_format::file_writer::FileWriter;

let mut fw = FileWriter::new();
let data: Vec<f64> = (0..50).map(|i| i as f64).collect();
fw.create_dataset("data")
    .with_f64_data(&data)
    .with_shape(&[50])
    .with_chunks(&[10])
    .with_maxshape(&[u64::MAX]); // unlimited dimension
let bytes = fw.finish().unwrap();
// h5py can open this file and resize/append to the dataset

use rustyhdf5_format::file_writer::{FileWriter, AttrValue};

let mut fw = FileWriter::new();
fw.set_root_attr("version", AttrValue::I64(1));

let mut grp = fw.create_group("experiment");
grp.create_dataset("temperatures")
    .with_f64_data(&[22.5, 23.1, 21.8])
    .with_shape(&[3])
    .set_attr("unit", AttrValue::String("celsius".into()));
let g = grp.finish();
fw.add_group(g);

let bytes = fw.finish().unwrap();

use rustyhdf5_format::file_writer::FileWriter;

let mut fw = FileWriter::new();
fw.create_dataset("sensor")
    .with_f64_data(&[22.5, 23.1, 21.8])
    .with_shape(&[3])
    .with_provenance("my-app/v1.0", "2026-02-19T12:00:00Z", Some("sensor_42"));
let bytes = fw.finish().unwrap();
// The file now contains _provenance_sha256, _provenance_creator,
// _provenance_timestamp, and _provenance_source attributes.
// Use rustyhdf5_format::provenance::verify_dataset() to check integrity.