A Bytecode Alliance project
Rust tooling for low-level manipulation of WebAssembly modules
This project can be installed and compiled from source with this Cargo command:
$ cargo install wasm-tools
Installation can be confirmed with:
$ wasm-tools --version
Subcommands can be explored with:
$ wasm-tools help
The wasm-tools binary internally contains a number of subcommands for working
with wasm modules. Many subcommands also come with Rust crates that can be use
programmatically as well:
| Tool | Crate | Description |
|---|---|---|
wasm-tools validate |
wasmparser | Validate a WebAssembly file |
wasm-tools parser |
wat and wast | Translate the WebAssembly text format to binary |
wasm-tools print |
wasmprinter | Translate the WebAssembly binary format to text |
wasm-tools smith |
wasm-smith | Generate a "random" valid WebAssembly module |
wasm-tools mutate |
wasm-mutate | Mutate an input wasm file into a new valid wasm file |
wasm-tools shrink |
wasm-shrink | Shrink a wasm file while preserving a predicate |
wasm-tools dump |
Print debugging information about the binary format | |
wasm-tools objdump |
Print debugging information about section headers |
The wasm-tools CLI is primarily intended to be a debugging aid. The various
subcommands all have --help explainer texts to describe more about their
functionality as well.
As mentioned above many of the tools of the wasm-tools CLI have libraries
implemented in this repository as well. These libraries are:
wasmparser- a library to parse WebAssembly binarieswat- a library to parse the WebAssembly text formatwast- likewat, except provides an ASTwasmprinter- prints WebAssembly binaries in their string formwasm-mutate- a WebAssembly test case mutatorwasm-shrink- a WebAssembly test case shrinkerwasm-smith- a WebAssembly test case generatorwasm-encoder- a crate to generate a binary WebAssembly module
It's recommended to use the libraries directly rather than the CLI tooling when embedding into a separate project.
This project is licensed 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.