|
1 | | -<h1 align="center">async-std</h1> |
2 | | -<div align="center"> |
3 | | - <strong> |
4 | | - Async version of the Rust standard library |
5 | | - </strong> |
6 | | -</div> |
| 1 | +# `async-std` has been discontinued; use `smol` instead |
7 | 2 |
|
8 | | -<br /> |
| 3 | +We created `async-std` to demonstrate the value of making a library as close to |
| 4 | +`std` as possible, but async. We think that demonstration was successful, and |
| 5 | +we hope it will influence future design and development directions of async in |
| 6 | +`std`. However, in the meantime, the [`smol`](https://github.com/smol-rs/smol/) |
| 7 | +project came about and provided a great executor and libraries for asynchronous |
| 8 | +use in the Rust ecosystem. We think that resources would be better spent |
| 9 | +consolidating around `smol`, rather than continuing to provide occasional |
| 10 | +maintenance of `async-std`. As such, we recommend that all users of |
| 11 | +`async-std`, and all libraries built on `async-std`, switch to `smol` instead. |
| 12 | + |
| 13 | +In addition to the `smol` project as a direct replacement, you may find other |
| 14 | +parts of the futures ecosystem useful, including `futures-concurrency`, |
| 15 | +`async-io`, `futures-lite`, and `async-compat`. |
9 | 16 |
|
10 | | -<div align="center"> |
11 | | - <!-- CI status --> |
12 | | - <a href="https://github.com/async-rs/async-std/actions"> |
13 | | - <img src="https://img.shields.io/github/actions/workflow/status/async-rs/async-std/ci.yml?branch=main&style=flat-square" |
14 | | - alt="CI Status" /> |
15 | | - </a> |
16 | | - <!-- Crates version --> |
17 | | - <a href="https://crates.io/crates/async-std"> |
18 | | - <img src="https://img.shields.io/crates/v/async-std.svg?style=flat-square" |
19 | | - alt="Crates.io version" /> |
20 | | - </a> |
21 | | - <!-- Downloads --> |
22 | | - <a href="https://crates.io/crates/async-std"> |
23 | | - <img src="https://img.shields.io/crates/d/async-std.svg?style=flat-square" |
24 | | - alt="Download" /> |
25 | | - </a> |
26 | | - <!-- docs.rs docs --> |
27 | | - <a href="https://docs.rs/async-std"> |
28 | | - <img src="https://img.shields.io/badge/docs-latest-blue.svg?style=flat-square" |
29 | | - alt="docs.rs docs" /> |
30 | | - </a> |
31 | | - |
32 | | - <a href="https://discord.gg/JvZeVNe"> |
33 | | - <img src="https://img.shields.io/discord/598880689856970762.svg?logo=discord&style=flat-square" |
34 | | - alt="chat" /> |
35 | | - </a> |
36 | | -</div> |
37 | 17 |
|
38 | 18 | <div align="center">
|
39 | 19 | <h3>
|
|
44 | 24 | <a href="https://book.async.rs">
|
45 | 25 | Book
|
46 | 26 | </a>
|
47 | | - <span> | </span> |
48 | | - <a href="https://github.com/async-rs/async-std/releases"> |
49 | | - Releases |
50 | | - </a> |
51 | | - <span> | </span> |
52 | | - <a href="https://async.rs/contribute"> |
53 | | - Contributing |
54 | | - </a> |
55 | 27 | </h3>
|
56 | 28 | </div>
|
57 | 29 |
|
@@ -111,38 +83,6 @@ creation, with an adaptive lock-free executor, threadpool and network driver to
|
111 | 83 | create a smooth system that processes work at a high pace with low latency,
|
112 | 84 | using Rust's familiar stdlib API.
|
113 | 85 |
|
114 | | -## Installation |
115 | | - |
116 | | -Run this in your projects folder: |
117 | | - |
118 | | -```sh |
119 | | -$ cargo add async-std |
120 | | -``` |
121 | | - |
122 | | -We also provide a set of "unstable" features with async-std. See the [features |
123 | | -documentation] on how to enable them. |
124 | | - |
125 | | -[cargo add]: https://doc.rust-lang.org/cargo/commands/cargo-add.html |
126 | | -[features documentation]: https://docs.rs/async-std/#features |
127 | | - |
128 | | -## Ecosystem |
129 | | - |
130 | | - * [async-tls](https://crates.io/crates/async-tls) β Async TLS/SSL streams using **Rustls**. |
131 | | - |
132 | | - * [async-native-tls](https://crates.io/crates/async-native-tls) β **Native TLS** for Async. Native TLS for futures and async-std. |
133 | | - |
134 | | - * [async-tungstenite](https://crates.io/crates/async-tungstenite) β Asynchronous **WebSockets** for async-std, tokio, gio and any std Futures runtime. |
135 | | - |
136 | | - * [Tide](https://crates.io/crates/tide) β Serve the web. A modular **web framework** built around async/await. |
137 | | - |
138 | | - * [SQLx](https://crates.io/crates/sqlx) β The Rust **SQL** Toolkit. SQLx is a 100% safe Rust library for Postgres and MySQL with compile-time checked queries. |
139 | | - |
140 | | - * [Surf](https://crates.io/crates/surf) β Surf the web. Surf is a friendly **HTTP client** built for casual Rustaceans and veterans alike. |
141 | | - |
142 | | - * [Xactor](https://crates.io/crates/xactor) β Xactor is a rust actors framework based on async-std. |
143 | | - |
144 | | - * [async-graphql](https://crates.io/crates/async-graphql) β A GraphQL server library implemented in rust, with full support for async/await. |
145 | | - |
146 | 86 | ## License
|
147 | 87 |
|
148 | 88 | <sup>
|
|
0 commit comments