#cargo #wasm-bindgen #order #wasi #process

bin+lib cargo-wasi-src

Subcommand for Cargo to easily build code for wasm32-wasi

25 releases

0.1.28 Jun 12, 2023
0.1.27 Feb 1, 2023
0.1.26 Jul 6, 2022
0.1.23 Jul 29, 2021
0.1.18 Nov 19, 2019

#1276 in WebAssembly

Download history 71/week @ 2023-08-04 77/week @ 2023-08-11 82/week @ 2023-08-18 112/week @ 2023-08-25 124/week @ 2023-09-01 90/week @ 2023-09-08 102/week @ 2023-09-15 101/week @ 2023-09-22 80/week @ 2023-09-29 114/week @ 2023-10-06 91/week @ 2023-10-13 103/week @ 2023-10-20 113/week @ 2023-10-27 70/week @ 2023-11-03 70/week @ 2023-11-10 79/week @ 2023-11-17

348 downloads per month
Used in cargo-wasi

Apache-2.0 WITH LLVM-exception


cargo wasi

A Bytecode Alliance project

A lightweight Cargo subcommand to build code for the wasm32-wasi target.

Crates.io version Download docs.rs docs

Guide | Contributing


To install this Cargo subcommand, first you'll want to install Rust and then you'll execute:

$ cargo install cargo-wasi

After that you can verify it works via:

$ cargo wasi --version

Read more about installation in the guide!


The cargo wasi subcommand is a thin wrapper around cargo subcommands, providing optimized defaults for the wasm32-wasi target. Using cargo wasi looks very similar to using cargo:

  • cargo wasi build — build your code in debug mode for the wasi target.

  • cargo wasi build --release — build the optimized version of your *.wasm.

  • cargo wasi run — execute a binary.

  • cargo wasi test — run your tests in wasm32-wasi.

  • cargo wasi bench — run your benchmarks in wasm32-wasi.

In general, if you'd otherwise execute cargo foo --flag you can likely execute cargo wasi foo --flag and everything will "just work" for the wasm32-wasi target.

To give it a spin yourself, try out the hello-world versions of programs!

$ cargo new wasi-hello-world
     Created binary (application) `wasi-hello-world` package
$ cd wasi-hello-world
$ cargo wasi run
   Compiling wasi-hello-world v0.1.0 (/code/wasi-hello-world)
    Finished dev [unoptimized + debuginfo] target(s) in 0.15s
     Running `cargo-wasi target/wasm32-wasi/debug/wasi-hello-world.wasm`
     Running `target/wasm32-wasi/debug/wasi-hello-world.wasm`
Hello, world!

Or a library with some tests:

$ cargo new wasi-hello-world --lib
     Created library `wasi-hello-world` package
$ cd wasi-hello-world
$ cargo wasi test
   Compiling wasi-hello-world v0.1.0 (/code/wasi-hello-world)
    Finished dev [unoptimized + debuginfo] target(s) in 0.19s
     Running target/wasm32-wasi/debug/deps/wasi_hello_world-9aa88657c21196a1.wasm
     Running `/code/wasi-hello-world/target/wasm32-wasi/debug/deps/wasi_hello_world-9aa88657c21196a1.wasm`

running 1 test
test tests::it_works ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out

Read more about cargo wasi usage in the guide!


This project is license under the Apache 2.0 license with the LLVM exception. See [LICENSE] for more details.


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

See the contributing section of the guide to start hacking on cargo wasi!


~410K SLoC