async-io-model
Explanations of common asynchronous patterns used in tursodb
by tursodatabaseFree
Description
Async I/O model is an agent skill that explains how the Turso database, written in Rust, handles asynchronous work. Turso does not use Rust's async and await. It uses cooperative yielding with explicit state machines instead. The skill documents the core types, starting with IOResult, which either reports Done with a value or reports that I/O is needed and that the caller should call the function again once the pending completions finish. Functions that return IOResult must therefore be called repeatedly until they return Done. It also covers IOCompletions, which holds a single completion or a group of them, the re-entrancy pitfalls that come with resuming state machines, and the CompletionGroup helper. The guide is written for people working on the database's own code, and the listing says the patterns should always be used when writing that code. It is listed on skills.sh under the Turso repository and passes the Gen Agent Trust Hub, Socket and Snyk security audits.…
Highlights
- Explains IOResult and cooperative yielding
- Covers explicit state machines instead of async and await
- Re-entrancy pitfalls to avoid
- CompletionGroup and IOCompletions types
Ratings & Reviews
No ratings yet
Be the first to rate async-io-model.
People also visit
code-quality
General Correctness rules, Rust patterns, comments, avoiding over-engineering
async-io-model FAQ
What does the skill explain?
The asynchronous patterns used in the tursodb engine, including the IOResult type, the state machines that drive I/O, and the re-entrancy pitfalls.
What is IOResult?
The return type of functions that may need I/O. It is either Done with a result, or IO with the completions to wait for, and the caller must call the function again until it is Done.
Who is it for?
Contributors writing code inside the Turso database. It is not a guide for apps that only use the database.
How do I install it?
Run npx skills add https://github.com/tursodatabase/turso --skill async-io-model.
What security audits has it passed?
skills.sh lists three audits: Gen Agent Trust Hub Pass, Socket Pass and Snyk Pass.
What are the best async-io-model alternatives?
Popular alternatives to async-io-model include code-quality, rust-async-patterns and debugging. See all async-io-model alternatives