Rust Async Patterns

by wshobson46891e7e60daNo licenseListed Oct 8, 2026Updated Oct 8, 2026

Master Rust async programming with Tokio, async traits, error handling, and concurrent patterns. Use when building async Rust applications, implementing concurrent systems, or debugging async code.

Instructions onlySoftware Development

AI-generated overview

Reference guidance for writing and debugging asynchronous Rust code with the Tokio runtime.

What it does: This skill supplies production patterns for asynchronous Rust programming, covering the async execution model, futures, tasks, runtimes, channels, streams, cancellation and error handling. It gives a quick-start Cargo dependency list and example code, plus do's and don'ts for concurrency. Deeper worked examples are deferred to a bundled reference file.
When to use it: Use it when building async Rust applications, implementing concurrent network services, adopting Tokio for async I/O, or debugging and optimizing async code. It also fits when handling async errors or reasoning about cancellation and task management.
Requirements: No scripts; instructions and a reference document only. The examples assume a Rust toolchain with Cargo and crates such as tokio, futures, async-trait, anyhow, tracing and tracing-subscriber.

Rust Async Patterns

Production patterns for async Rust programming with Tokio runtime, including tasks, channels, streams, and error handling.

When to Use This Skill

Building async Rust applications
Implementing concurrent network services
Using Tokio for async I/O
Handling async errors properly
Debugging async code issues
Optimizing async performance

Core Concepts

1. Async Execution Model

Future (lazy) → poll() → Ready(value) | Pending                ↑           ↓              Waker ← Runtime schedules

Future (lazy) → poll() → Ready(value) | Pending                ↑           ↓              Waker ← Runtime schedules

2. Key Abstractions

Concept	Purpose
`Future`	Lazy computation that may complete later
`async fn`	Function returning impl Future
`await`	Suspend until future completes
`Task`	Spawned future running concurrently
`Runtime`	Executor that polls futures

Quick Start

toml

# Cargo.toml[dependencies]tokio = { version = "1", features = ["full"] }futures = "0.3"async-trait = "0.1"anyhow = "1.0"tracing = "0.1"tracing-subscriber = "0.3"

# Cargo.toml[dependencies]tokio = { version = "1", features = ["full"] }futures = "0.3"async-trait = "0.1"anyhow = "1.0"tracing = "0.1"tracing-subscriber = "0.3"

rust

use tokio::time::{sleep, Duration};use anyhow::Result;
#[tokio::main]async fn main() -> Result<()> {    // Initialize tracing    tracing_subscriber::fmt::init();
    // Async operations    let result = fetch_data("https://api.example.com").await?;    println!("Got: {}", result);
    Ok(())}
async fn fetch_data(url: &str) -> Result<String> {    // Simulated async operation    sleep(Duration::from_millis(100)).await;    Ok(format!("Data from {}", url))}

use tokio::time::{sleep, Duration};use anyhow::Result;
#[tokio::main]async fn main() -> Result<()> {    // Initialize tracing    tracing_subscriber::fmt::init();
    // Async operations    let result = fetch_data("https://api.example.com").await?;    println!("Got: {}", result);
    Ok(())}
async fn fetch_data(url: &str) -> Result<String> {    // Simulated async operation    sleep(Duration::from_millis(100)).await;    Ok(format!("Data from {}", url))}

Detailed patterns and worked examples

Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.

Best Practices

Do's

Use tokio::select! - For racing futures
Prefer channels - Over shared state when possible
Use JoinSet - For managing multiple tasks
Instrument with tracing - For debugging async code
Handle cancellation - Check CancellationToken

Don'ts

Don't block - Never use std::thread::sleep in async
Don't hold locks across awaits - Causes deadlocks
Don't spawn unboundedly - Use semaphores for limits
Don't ignore errors - Propagate with ? or log
Don't forget Send bounds - For spawned futures

Source and attribution

Source:wshobson/agentsinplugins/systems-programming/skills/rust-async-patternsat commit46891e7

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Rust Async Patterns

Rust Async Patterns

When to Use This Skill

Core Concepts

1. Async Execution Model

2. Key Abstractions

Quick Start

Detailed patterns and worked examples

Best Practices

Do's

Don'ts

Source and attribution

More from wshobson/agents

Uv Package Manager

Web Component Design

Python Type Safety

Visual Design Foundations

Responsive Design

Python Resource Management

More in Software Development

Playground

M5 Onboard

Cardputer Buddy

Dpop Adoption

Gemini Live Api

Gemini Api