Crate io_vdir 

io-vdir

I/O-free Vdir coroutines: every filesystem operation on a vdir tree is a resumable state machine that emits requests (create a directory, read a file, rename a path, draw random bytes) instead of performing the I/O itself. The caller services each request and resumes the coroutine, so the same logic drives blocking, async or in-memory harnesses without change.

Layers

The core coroutine layer is no_std and pulls no runtime: it defines the coroutine::VdirCoroutine trait, the shared coroutine::VdirYield request and coroutine::VdirReply response enums, and the vdir_try! macro that chains one coroutine into another. The optional client feature adds client::VdirClient, a blocking client that runs any coroutine against the local filesystem through std::fs.

Layout

The source tree mirrors the two Vdir concepts. collection owns the collection::VdirCollection handle and one coroutine per directory operation (create, delete, list, rename, update). item owns the item::VdirItem handle, its item::VdirItemKind and one coroutine per item operation (store, get, list, locate, copy, move, delete). path holds the forward-slash path::VdirPath newtype shared across both.

Encoding

Items are opaque bytes at every level: io-vdir never parses them, leaving the choice of vCard or iCalendar parser to the caller. The serde feature derives (de)serialization on the public handles.

Modules

clientclient

Standard, blocking Vdir client driving any coroutine against std::fs.

collection

Vdir collections: the VdirCollection handle plus the I/O-free coroutines managing collection directories and their metadata files (create, delete, list, rename, update).

coroutine

Generator-shape coroutine driver

item

Vdir items: the VdirItem handle and its VdirItemKind, plus the I/O-free coroutines for the item lifecycle (store, get, list, locate, copy, move, delete).

path

Forward-slash separated path used by Vdir coroutines.

Macros

vdir_try

Coroutine ?: forwards Yielded (via Into), short-circuits on Err, evaluates to the inner Ok value.