Async Rust Guidebook

Learn asynchronous Rust from observable programs, then follow the machinery only as far as it explains the behavior.

Async Rust combines several ideas that are easier to understand separately:

• a future represents work that may not be complete yet;
• .await allows one task to pause without blocking its executor thread;
• a runtime polls tasks and connects them to timers, networking, and wakeups;
• concurrency lets multiple operations make progress during overlapping time;
• cancellation often happens by dropping a future before it completes.

This book should introduce each idea through a complete program and its observed output before explaining implementation machinery.

consumer program
    → observed order and timing
    → public Future or runtime contract
    → one source-level mechanism
    → cancellation and ownership consequences

The current pages are a chapter skeleton for the next author. The navigation, typography, syntax colors, and responsive page controls are already configured.

Start with how to read the examples →