WASM-TOOLS(1)

📦 version 1.239.0, in ubuntu stonking

💖 WASM-TOOLS(1) 💖

okay bestie, sit down, we're doing the wasm-tools parse page from the User Commands manual and it is so good. this is the girlies' guide to turning WebAssembly text into WebAssembly binary. no cap. 🦋

✨ NAME ✨

wasm-tools parse — parse the WebAssembly text format. that's it. that's the whole job. iconic behavior. 💅

🌸 SYNOPSIS 🌸

wasm-tools parse [OPTIONS] [INPUT]

look at her. short. sweet. powerful. main character energy fr fr. 💜

🎀 DESCRIPTION 🎀

okay so. this subcommand parses whatever input you hand it as the WebAssembly text format, and then — if you want — writes the binary form out to a file you pick. it's giving translator. it's giving glow-up. it's giving .wat to .wasm pipeline and honestly? obsessed. ✨

🍓 Arguments:

  • [INPUT] — the input file to process. 🫶

now here's the tea: if you don't provide it, or if you literally just pass -, then stdin is read entirely and processed. and bestie, note this — for most subcommands this input can either be a binary *.wasm file or a textual format *.wat file. flexible queen. 💅

🌈 OPTIONS 🌈

  • --generate-dwarf <lines|full> — optionally generate DWARF debugging information from WebAssembly text files. 🔥

so when the input to this command is a WebAssembly text file, like *.wat, this option tells the text parser to insert DWARF debugging information to map binary locations back to the original source locations in the input *.wat file. and listen — this option has no effect if the INPUT argument is already a WebAssembly binary, or if the text format uses (module binary ...). she said know your limits. 💀

  • -g — shorthand for --generate-dwarf full. tiny. efficient. we love a shortcut. 🎀
  • -o, --output <OUTPUT> — where to place output. if you don't provide it, then stdout is used. so either you tell her where to go or she picks the default spot herself. independent icon. 💜
  • -v, --verbose... — use verbose output (-v info, -vv debug, -vvv trace). the more v's, the more she tells you. spill the tea, levels of it. 🌸
  • --color <COLOR> — configuration over whether terminal colors are used in output. 🎨

supports one of auto|never|always|always-ansi. the default is to detect what to do based on the terminal environment, for example by using isatty.

[default: auto]

  • -t, --wat — output the text format of WebAssembly instead of the binary format. yes bestie, she can also go backwards. bi-directional legend. ⭐
  • -h, --help — print help (see a summary with -h). your girl is here if you need her. 🫶
⚠️ real talk: keep an eye on --generate-dwarf doing nothing when the input is already a binary or when the text uses (module binary ...). that's not a bug, that's just the rules. 🙈

and that's the page, bestie!! 🧚 run it, parse it, ship it. this was wasm-tools parse, version 1.239.0+ds, dated August 2026 — sending you off with love, a lil sparkle, and the whole WASM-TOOLS(1) vibe. mwah. 💖✨🌈👑

📦 where this page comes from