tokio-rs/turmoil

Health v2 · maintenance only

Adoption not part of the score

1250 stars · 74 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Turmoil is a family of Rust crates for deterministic simulation testing of distributed systems, running multiple concurrent hosts on a single thread. It injects hardship such as latency, drops, partitions, crashes, and torn writes into simulated networks and filesystems under manual control or a seeded RNG.

Use cases

• test distributed systems against network partitions deterministically
• simulate latency and packet drops in Rust integration tests
• reproduce race conditions with seeded RNG simulation testing
• test crash recovery and torn write handling
• simulate a tokio network stack in-process
• test filesystem failure handling with a simulated fs

When to choose

• you build distributed systems in Rust and need deterministic fault injection
• you want reproducible tests for network partitions and crashes
• you use tokio and want drop-in simulated net/fs replacements

When to avoid

• you need to test real network behavior against actual hosts
• your code is not written in Rust or not adaptable to simulated IO
• you only need simple unit or property testing without fault injection

Facets

framework · maturity active

testing simulation developer-tools testing microservices developer-tools rust cross-platform deterministic-simulation-testing network-partition-testing fault-injection tokio

Member repositories

For agents

markdown · JSON · MCP: product_card(name="tokio-rs/turmoil")