#wasm-component #component #async #stdlib #async-io

wstd

An async standard library for Wasm Components and WASI 0.2

4 releases (breaking)

0.4.0 Jul 29, 2024
0.3.0 Jul 26, 2024
0.2.0 Jul 26, 2024
0.1.0 Jul 26, 2024

#182 in WebAssembly

Download history 162/week @ 2024-07-20 223/week @ 2024-07-27 6/week @ 2024-08-03 5/week @ 2024-09-14 15/week @ 2024-09-28 72/week @ 2024-10-05

92 downloads per month

MIT OR Apache-2…

58KB
1K SLoC

wstd

An async standard library for Wasm Components and WASI 0.2

This is a minimal async standard library written exclusively to support Wasm Components. It exists primarily to enable people to write async-based applications in Rust before async-std, smol, or tokio land support for Wasm Components and WASI 0.2. Once those runtimes land support, it is recommended users switch to use those instead.

Examples

TCP echo server

use wstd::io;
use wstd::iter::AsyncIterator;
use wstd::net::TcpListener;
use wstd::runtime::block_on;

fn main() -> io::Result<()> {
    block_on(|reactor| async move {
        let listener = TcpListener::bind(&reactor, "127.0.0.1:8080").await?;
        println!("Listening on {}", listener.local_addr()?);
        println!("type `nc localhost 8080` to create a TCP client");

        let mut incoming = listener.incoming();
        while let Some(stream) = incoming.next().await {
            let stream = stream?;
            println!("Accepted from: {}", stream.peer_addr()?);
            io::copy(&stream, &stream).await?;
        }
        Ok(())
    })
}

Installation

$ cargo add wstd

Safety

This crate uses #![deny(unsafe_code)] to ensure everything is implemented in 100% Safe Rust.

Contributing

Want to join us? Check out our "Contributing" guide and take a look at some of these issues:

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.

Dependencies

~2.5MB
~55K SLoC