What runtimes are supported by these patterns?

These patterns focus primarily on the Tokio runtime, which is the industry standard for asynchronous I/O in Rust.

Can I use these patterns for CPU-intensive tasks?

Yes, it details the spawn_blocking pattern which is essential for offloading CPU-heavy work without stalling the async executor.

Does this skill cover testing async code?

Yes, it includes patterns for unit testing with #[tokio::test] and integration testing across sync/async boundaries.

Is feature-gating supported?

Yes, the skill demonstrates how to conditionally enable async code paths using Cargo features, allowing libraries to remain lightweight for sync-only users.

How does this help with FFI bindings?

It provides specific patterns for ensuring Rust types are Send and Sync, which is critical for memory safety when exposing Rust code to languages like Python (PyO3) or Node.js (NAPI-RS).

Rust Async/Await & Module Patterns

Name: Rust Async/Await & Module Patterns
Author: kreuzberg-dev

bykreuzberg-dev

•

480

•

Developer Tools

Provides architectural patterns and best practices for implementing async/await and thread-safe Tokio runtimes in Rust projects.

This skill offers a comprehensive guide for managing asynchronous workflows in Rust, specifically focused on Tokio runtime integration and FFI safety. It provides implementation patterns for global runtimes, dedicated worker pools, and feature-gated async paths, while ensuring strict adherence to Send and Sync requirements for cross-language interoperability. By following these established patterns, developers can avoid common pitfalls like runtime exhaustion, thread safety violations, and blocking the executor, leading to more robust and performant polyglot applications.

Key Features

01Strict Send + Sync safety checks for FFI and multi-threaded contexts

02Bridging strategies for calling async Rust from synchronous host languages

03Proven Tokio runtime patterns for shared or dedicated thread pools

04Structured module organization for separating sync and async logic

05Comprehensive unit and integration testing patterns for async code

06480 GitHub stars

Use Cases

01Building high-performance FFI bindings for Python, Node.js, or Ruby using Rust

02Converting synchronous libraries to support asynchronous execution paths

03Architecting scalable async services with the Tokio runtime

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kreuzberg-dev/html-to-markdown rust-async-await-module-patterns

For use in Claude.ai and ChatGPT

Download Skill