structfs-handles 0.3.0

Handle-store and streaming primitives for StructFS: outstanding/{id} scaffolding, atomic tail reads, cancellable parked reads
Documentation

structfs-handles

Handle ownership, cancellation and streaming primitives for deferred operations.

Usage

HandleStore implements the outstanding/{id} lifecycle via HandleProtocol. TailLog provides atomic items-and-terminal-status reads. Gate and CancelToken support parked reads. Use DuplexStream for bounded consuming binary streams; append-only ByteStream has different retention semantics. The conformance module validates custom handle implementations.

Version and support

The 0.3 release line supports Rust 1.96+. See the API documentation for compiled examples and full contracts. Read the migration guide before upgrading code or persisted data. The release procedure describes package, platform and feature verification.

Disable default features for portable cancellation, gates, streams and handle stores. sync-bridge (default) adds the native blocking bridge's Tokio runtime requirement; it does not require the multi-thread executor. See the platform matrix for tested combinations.