Async version of Rust's standard library

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.

Documentation

async-std comes with extensive API documentation and a book.

Quickstart

Add the following lines to you Cargo.toml:

toml [dependencies] async-std = "0.99"

Or use cargo add if you have it installed:

sh $ cargo add async-std

Hello world

```rust

![feature(async_await)]

use async_std::task;

fn main() { task::block_on(async { println!("Hello, world!"); }) } ```

Low-Friction Sockets with Built-In Timeouts

```rust

![feature(async_await)]

use std::time::Duration;

use async_std::{ prelude::*, task, io, net::TcpStream, };

async fn get() -> io::Result> { let mut stream = TcpStream::connect("example.com:80").await?; stream.write_all(b"GET /index.html HTTP/1.0\r\n\r\n").await?;

let mut buf = vec![];

io::timeout(Duration::from_secs(5), async {
    stream.read_to_end(&mut buf).await?
    Ok(buf)
})

}

fn main() { task::blockon(async { let rawresponse = get().await.expect("request"); let response = String::fromutf8(rawresponse) .expect("utf8 conversion"); println!("received: {}", response); }); } ```

Take a look around

Clone the repo:

git clone git@github.com:async-rs/async-std.git && cd async-std

Generate docs:

cargo doc --features docs.rs --open

Check out the examples. To run an example:

cargo run --example hello-world

Contributing

See our contribution document.

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.