Crate kithara_storage 

kithara-storage

Storage primitives for Kithara.

Provides a generic Resource<D> parameterized by a Driver:

• MmapResource — mmap-backed (filesystem), with lock-free fast path.
• MemResource — in-memory Vec<u8> (WASM).

StorageResource is a unified enum combining both backends.

The consumer-facing trait is ResourceExt.

Structs

Atomic

Decorator for crash-safe whole-file writes.

AtomicChunked

Decorator for crash-safe chunked writes.

MemDriver

In-memory storage driver backed by a growable byte pool buffer.

MemOptions

Options for creating a MemResource.

MmapDriver

Mmap-backed storage driver.

MmapOptions

Options for opening a MmapResource.

Resource

Generic storage resource parameterized by backend driver.

Enums

OpenIntent

Hint passed to the factory closure to disambiguate the two lifecycle calls.

OpenMode

Controls how MmapDriver opens the backing file.

ResourceStatus

Status of a resource.

StorageError

Errors produced by storage primitives.

StorageResource

Unified resource: disk (mmap) or memory backend.

WaitOutcome

Outcome of waiting for a byte range.

Traits

AvailabilityObserver

Observer notified when a Resource<D> gains bytes or finalizes.

Driver

Driver factory + I/O contract.

DriverIo

Backend-specific storage operations.

ResourceExt

Unified sync resource trait.

Type Aliases

MemResource

In-memory storage resource.

MmapResource

Mmap-backed storage resource.

StorageResult

Result type used by kithara-storage.