Rust compiler toolkit for WebAssembly apps in the WasmEdge Runtime
A one-stop tool for building Rust functions into WebAssembly for deployment on the WasmEdge Runtime.
You will need to install the Rust compiler in order to use
rustwasmc. Currently, we support up to Rust 1.50.0.
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh $ source $HOME/.cargo/env
From Linux command line
$ curl https://raw.githubusercontent.com/second-state/rustwasmc/master/installer/init.sh -sSf | sh
From NPM and Node.js
$ npm install -g rustwasmc # Append --unsafe-perm if permission denied
To build Rust functions for Node.js applications, use the following command. See a template application. The
wasm-wasi file for running as a standalone command program in the WasmEdge VM.
$ rustwasmc build
In most cases, you will want to enable AOT optimization in order to improve performance.
$ rustwasmc build --enable-aot
If you would like to use WasmEdge's extended APIs including Tensorflow, enable the extensions. Make sure that you install the
wasmedge-extensions NPM module in this case.
$ rustwasmc build --enable-aot --enable-ext
To build Rust functions for Deno applications, use the following command. See a template application.
$ rustwasmc build --target deno
By default, rustwasmc will generate a directory for it's build output called pkg. If you'd like to customize this you can use the --out-dir flag.
$ rustwasmc build --out-dir out
Use clean subcommand to remove pkg and target directories.
$ rustwasmc clean
env_logger to produce logs when
To configure your log level, use the
RUST_LOG environment variable. For example:
$ RUST_LOG=info rustwasmc build
For Rust version 1.51 and above,
rustwasmc generates bytecode without WASI support. That means programs that access the file system, date and time, environment variables, and command line arguments would fail on Rust 1.50+. This should not affect most application use cases. We are working on a solution.
This project is derived from the open source wasm-pack.