2
0
Fork 1
mirror of https://github.com/async-rs/async-std.git synced 2025-04-01 05:56:41 +00:00
No description
Find a file
Josh Triplett 96f564672a
Merge pull request #1099 from joshtriplett/🌇
Officially sunset async-std
2025-03-15 14:59:20 -07:00
.github Add MSRV 1.63 to CI 2024-09-11 06:51:22 +08:00
benches Optimization: a slot for the next task to run (#529) 2019-11-13 20:32:37 +01:00
ci Switch branch name to main 2022-06-02 11:17:20 -07:00
docs Fix typo: at a time instead of at time 2023-11-25 19:55:26 -08:00
examples silence warnings reported by newer rust versions 2024-08-21 10:13:50 +02:00
src Remove deny(warnings) which is causing CI to fail 2025-03-01 21:20:34 +00:00
tests don't poll the reader again after eof while waiting for the writer to flush 2022-06-02 15:32:40 -07:00
.gitignore Initial commit 2019-08-08 14:44:48 +02:00
Cargo.toml Officially sunset async-std 2025-03-01 21:20:34 +00:00
CHANGELOG.md Officially sunset async-std 2025-03-01 21:20:34 +00:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2019-08-12 20:02:31 +02:00
LICENSE-APACHE Initial commit 2019-08-08 14:44:48 +02:00
LICENSE-MIT Initial commit 2019-08-08 14:44:48 +02:00
README.md Officially sunset async-std 2025-03-01 21:20:34 +00:00

async-std has been discontinued; use smol instead

We created async-std to demonstrate the value of making a library as close to std as possible, but async. We think that demonstration was successful, and we hope it will influence future design and development directions of async in std. However, in the meantime, the smol project came about and provided a great executor and libraries for asynchronous use in the Rust ecosystem. We think that resources would be better spent consolidating around smol, rather than continuing to provide occasional maintenance of async-std. As such, we recommend that all users of async-std, and all libraries built on async-std, switch to smol instead.

In addition to the smol project as a direct replacement, you may find other parts of the futures ecosystem useful, including futures-concurrency, async-io, futures-lite, and async-compat.


This crate provides an async version of std. It provides all the interfaces you are used to, but in an async version and ready for Rust's async/await syntax.

Features

  • Modern: Built from the ground up for std::future and async/await with blazing fast compilation time.
  • Fast: Our robust allocator and threadpool designs provide ultra-high throughput with predictably low latency.
  • Intuitive: Complete parity with the stdlib means you only need to learn APIs once.
  • Clear: Detailed documentation and accessible guides mean using async Rust was never easier.

Examples

use async_std::task;

async fn say_hello() {
    println!("Hello, world!");
}

fn main() {
    task::block_on(say_hello())
}

More examples, including networking and file access, can be found in our examples directory and in our documentation.

Philosophy

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

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

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.