Crate sparseio 

SparseIO - A Rust library for efficient sparse I/O operations. This library provides an interface to define how to efficiently read from and write to sparse objects, while tracking cache coverage and in-flight operations to optimize performance and resource usage in order to deduplicate work done across multiple I/O operations.

Modules

debug

Opt-in validation harnesses for downstream backend verification.

sources

Implementations of the crate::Reader, and crate::Writer for dealing with common use cases. Usages of such sources are shown in the examples, and they can be used as building blocks for more complex custom sources, references for building your own source, or as-is.

utils

Opt-in helper utilities for examples, tests, and downstream validation.

Structs

Builder

Builder pattern for constructing a crate::SparseIO instance. This allows callers to specify required and optional fields, and provides validation before constructing the final instance.

SparseIO

User-facing API for sparse I/O operations. Provides an interface to read from a sparse object, which is backed by an crate::Writer for storing filled in extents, and a crate::Reader for the actual I/O operations.

Viewer

Viewer type for the sparse I/O library. This struct provides an interface to read from a sparse object opened via crate::SparseIO.

Traits

Reader

Trait describing how SparseIO reads bytes from an upstream source.

Writer

Trait describing how SparseIO stores sparse extents.