format: add the Storage trait; make the error enums non-exhaustive

Range-read milestone M1, first step (docs/design/range-reads.md §3(a)):
a synchronous, no_std read interface with u64 offsets, read_at returning
Cow<[u8]>, read_ranges, len and an as_contiguous fast path. Implemented
for [u8], Vec<u8>, &T, Box<T> and Arc<T>; slices serve borrowed bytes.
read_exact_at reproduces the parsers' UnexpectedEof bounds error exactly,
so converted modules keep their error values.

FormatError gains Storage(String) and ContiguousStorageRequired; it and
the facade Error are now #[non_exhaustive] (breaking for exhaustive
matches, noted in the changelog; the Python bindings' match gets a
wildcard arm).

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>

This commit is contained in:

osobh

2026-09-26 12:44:36 -05:00

co-authored by

Claude Opus 5.5

parent f2ff2c424f

commit 6a4707d791

6 changed files with 399 additions and 0 deletions

									
										crates/clawhdf5-format/src/lib.rs
									
		+1
		
												View File
												
				@@ -120,6 +120,7 @@ pub mod property_list;

				pub mod selection;

				pub mod shared_message;

				pub mod signature;

				pub mod storage;

				pub mod superblock;

				pub mod superblock_ext;

				pub mod symbol_table;