Repository files navigation

We createdasync-std to demonstrate the value of making a library as close tostd as possible, but async. We think that demonstration was successful, andwe hope it will influence future design and development directions of async instd. However, in the meantime, thesmolproject came about and provided a great executor and libraries for asynchronoususe in the Rust ecosystem. We think that resources would be better spentconsolidating aroundsmol, rather than continuing to provide occasionalmaintenance ofasync-std. As such, we recommend that all users ofasync-std, and all libraries built onasync-std, switch tosmol instead.

In addition to thesmol project as a direct replacement, you may find otherparts of the futures ecosystem useful, includingfutures-concurrency,async-io,futures-lite, andasync-compat.

This crate provides an async version ofstd. It provides all the interfacesyou are used to, but in an async version and ready for Rust'sasync/awaitsyntax.

• Modern: Built from the ground up forstd::future andasync/await withblazing fast compilation time.
• Fast: Our robust allocator and threadpool designs provide ultra-highthroughput with predictably low latency.
• Intuitive: Complete parity with the stdlib means you only need to learnAPIs once.
• Clear:Detailed documentation andaccessible guides meanusing async Rust was never easier.

use async_std::task;asyncfnsay_hello(){println!("Hello, world!");}fnmain(){    task::block_on(say_hello())}

More examples, including networking and file access, can be found in ourexamples directory and in ourdocumentation.

We believe Async Rust should be as easy to pick up as Sync Rust. We also believethat the best API is the one you already know. And finally, we believe thatproviding an asynchronous counterpart to the standard library is the best waystdlib provides a reliable basis for both performance and productivity.

Async-std is the embodiment of that vision. It combines single-allocation taskcreation, with an adaptive lock-free executor, threadpool and network driver tocreate a smooth system that processes work at a high pace with low latency,using Rust's familiar stdlib API.