tinywasm-cli

The tinywasm-cli package installs the tinywasm binary for tinywasm. See tinywasm for the embedding API. It is recommended to use the library directly instead of the CLI.

The crate also exposes reusable helpers such as tinywasm_cli::wast_runner::WastRunner so workspace tests can drive the same WAST execution logic directly.

Usage

$ cargo install tinywasm-cli --version 0.9.0 --bin tinywasm
$ tinywasm --help
$ tinywasm ./module.wasm
$ tinywasm run --invoke add ./module.wasm 1 2
$ tinywasm compile ./module.wat -o ./module.twasm
$ tinywasm dump ./module.twasm
$ tinywasm inspect ./module.wasm
$ tinywasm wast ./spec-tests/address.wast

Notes:

• run, dump, and inspect accept .wasm, .wat, and .twasm inputs.
• Use - as the input path to read a module from stdin.
• Without --invoke, tinywasm expects the module to have a start function or _start export.
• compile writes TinyWasm's twasm archive format.
• Function invocation arguments are parsed from the export signature, so tinywasm run --invoke add ./module.wasm 1 2 works without repeating Wasm types on the command line.
• inspect uses ANSI colors automatically when writing to a terminal; set NO_COLOR=1 to disable them.
• Stack flags support both fixed sizes like --value-stack-size 4096 and dynamic sizes like --value-stack-dynamic 1024:8192.
• wast is a separate command for WebAssembly spec scripts and accepts files or folders containing .wast files.