README.md

Add hardship to your tests.

Turmoil is a family of crates for deterministic simulation testing of distributed systems. It runs multiple concurrent hosts within a single thread and injects "hardship" — latency, drops, partitions, crashes, torn writes — into the simulated network and filesystem, under manual control or a seeded RNG.

Crates

Crate	Description
turmoil	Full simulation-testing framework. Start here.
turmoil-net	Deterministic simulated socket stack. Drop-in replacement for tokio::net.
turmoil-fs	Deterministic simulated filesystem. Drop-in replacement for std::fs / tokio::fs.
turmoil-io-uring	Deterministic simulated io_uring. Optional fs feature wires it to turmoil-fs.

Examples

See examples/ for end-to-end samples, and each crate's tests/ directory for smaller, feature-focused tests.

License

This project is licensed under the MIT license.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in Turmoil by you, shall be licensed as MIT, without any additional terms or conditions.