blog: Running Wasm Components From the Command Line (approved) by tpmccallum · Pull Request #126 · bytecodealliance/bytecodealliance.org

tpmccallum · 2025-04-04T13:02:40Z

This is an article demonstrating how to use the wasmtime run --invoke feature. It explains WAVE syntax and implements a component with an exported function that is invoked in the Wasmtime CLI.

Relates to Zulip chat at #wasmtime > Article announcing the new `--invoke` feature. @ 💬

Related GitHub URLs:

_posts/2025-04-10-invoking-component-functions-in-wasmtime-cli.md

Great point, thanks so. much! Co-authored-by: bjorn3 <17426603+bjorn3@users.noreply.github.com>

vados-cosmonic

Hey @tpmccallum thanks for writing this, this is an awesome intro to how to use wasmtime --invoke! I left a bunch of comments but feel free to take or leave any of them -- most are almost NIT level.

I know that trying to strike the balance between technical and approachable is absolutely devilish to pull off so feel free to ignore any overly technical points I made!

_posts/2025-04-10-invoking-component-functions-in-wasmtime-cli.md

Co-authored-by: Victor Adossi <123968127+vados-cosmonic@users.noreply.github.com>

_posts/2025-04-10-invoking-component-functions-in-wasmtime-cli.md

vados-cosmonic

Thanks for the hard work here -- I still have a few comments, but feel free to take/leave them!

_posts/2025-04-10-invoking-component-functions-in-wasmtime-cli.md

Co-authored-by: Victor Adossi <123968127+vados-cosmonic@users.noreply.github.com>

pchickey

This is a great introductory blog post - thank you very much @tpmccallum for all your help getting the invoke PR across the finish line, and for writing this up!

vados-cosmonic

Thanks for making the changes @tpmccallum

On the interface/raw function export change, I think the --invoke invocation would change, so if you decide to take that change then running through it just once more is probably worth doing :)

…ew comment.

tpmccallum · 2025-04-15T01:40:46Z

Thanks, @pchickey
Absolute pleasure! Congratulations on implementing such a great feature.

Thanks, @vados-cosmonic
I have updated the example to include the best practice of using the interface approach.
Further, I gave the article one final read-through and tested all the code and configuration (.wit, .rs, .toml, etc.) on the latest wasmtime commit. Works like a charm 💯

wasm_answer % wasmtime --version
wasmtime 33.0.0 (4d0a43fd0 2025-04-14)
wasm_answer % cargo component build --target wasm32-wasip2 --release                            
  Generating bindings for wasm_answer (src/bindings.rs)
    Finished `release` profile [optimized] target(s) in 0.01s
wasm_answer % wasmtime run --invoke 'get-answer()' target/wasm32-wasip2/release/wasm_answer.wasm
42

Please let me know if you need me to tweak the date in the .md or the file name's date (regarding the publish date). I am happy with it from my end and looking forward to this publishing when practicable for wasmtime release schedule etc.

Chat soon
Tim

vados-cosmonic · 2025-04-15T02:18:05Z

Thanks for really putting in the work here @tpmccallum -- this is going to be an amazing entry point for people into the ecosystem.

Just setting the `date` frontmatter to a future publishing date.

pchickey

Only marking this as "request changes" because I think we need to delay publishing until Wasmtime 33 is out. Also, I believe the policy is we need someone on the TSC to sign this off? one of @ricochet @ospencer @abrown @tschneidereit please

pchickey · 2025-04-25T16:52:42Z

_posts/2025-04-25-invoking-component-functions-in-wasmtime-cli.md

+* [Rust](https://www.rust-lang.org/tools/install) (if you already have Rust installed, make sure you are on [the latest version](https://github.com/rust-lang/rust/releases)),
+* [`cargo`](https://crates.io/crates/cargo) (if already installed, please make sure you are on [the latest version](https://crates.io/crates/cargo)),
+* [`cargo component`](https://crates.io/crates/cargo-component) (if already installed, please make sure you are on [the latest version](https://crates.io/crates/cargo-component)), and
+* [`wasmtime` CLI](https://docs.wasmtime.dev/cli-install.html) (or use a [precompiled binary](https://docs.wasmtime.dev/cli-install.html#download-precompiled-binaries)). If already installed, ensure you are using [the latest version](https://github.com/bytecodealliance/wasmtime/releases).


We should wait to publish this until Wasmtime 33 is out - invoke didnt make it into the Wasmtime 32 release. I'd amend this to say it requires wasmtime 33 specifically, rather than the latest.

Thank you @pchickey
I have updated the filename and the date in the frontmatter to align with the next expected release.
I have also updated the wasmtime section to specify v33.0.0 or newer.
Changes are in cb41248.
Ready for sign off cc: @ricochet @ospencer @abrown @tschneidereit.
Kind regards
Tim

@tpmccallum and I have talked about this but for anyone else wondering: this is on the agenda for the next TSC meeting (no hurry since we expect it to be published later in May).

abrown

This was discussed today in the TSC and we are all in favor of this being merged once Wasmtime v33 is out. Thanks again for working on this!

ospencer

This will be an excellent addition to the blog; thanks @tpmccallum for writing, and thank you to the others for their thorough reviews!

tpmccallum added 3 commits April 4, 2025 22:58

Adding draft article re: wasmtime run --invoke

da6ab76

Adding draft article re: wasmtime run --invoke

f00ef20

Format tree command and add WAVE link

9b547fc

bjorn3 reviewed Apr 4, 2025

View reviewed changes

_posts/2025-04-10-invoking-component-functions-in-wasmtime-cli.md Outdated Show resolved Hide resolved

bjorn3 reviewed Apr 4, 2025

View reviewed changes

_posts/2025-04-10-invoking-component-functions-in-wasmtime-cli.md Outdated Show resolved Hide resolved

tpmccallum and others added 2 commits April 5, 2025 09:54

Update _posts/2025-04-10-invoking-component-functions-in-wasmtime-cli.md

d7d792c

Great point, thanks so. much! Co-authored-by: bjorn3 <17426603+bjorn3@users.noreply.github.com>

Respond to review feedback --invoke and single quote updates

9d45d6d

tpmccallum requested a review from bjorn3 April 5, 2025 00:06

tpmccallum mentioned this pull request Apr 5, 2025

wasmtime-cli: support run --invoke for components using wave bytecodealliance/wasmtime#10054

Merged

vados-cosmonic reviewed Apr 6, 2025

View reviewed changes

tpmccallum and others added 3 commits April 6, 2025 15:25

Update 2025-04-10-invoking-component-functions-in-wasmtime-cli.md

adbf586

Co-authored-by: Victor Adossi <123968127+vados-cosmonic@users.noreply.github.com>

Update 2025-04-10-invoking-component-functions-in-wasmtime-cli.md

991f938

Co-authored-by: Victor Adossi <123968127+vados-cosmonic@users.noreply.github.com>

Commit responding to some of the review points

5001fad

tpmccallum commented Apr 7, 2025

View reviewed changes

_posts/2025-04-10-invoking-component-functions-in-wasmtime-cli.md Outdated Show resolved Hide resolved

Responding to all review comments

ccd81f3

tpmccallum requested a review from vados-cosmonic April 12, 2025 02:02

tpmccallum added 3 commits April 12, 2025 12:17

Update in readiness for final review/publishing

be5c494

Some final adjustments made during markdown preview

9d253c5

Adjust headings

fc9f406

vados-cosmonic reviewed Apr 14, 2025

View reviewed changes

tpmccallum and others added 3 commits April 14, 2025 14:09

Update _posts/2025-04-10-invoking-component-functions-in-wasmtime-cli.md

477cb6f

Co-authored-by: Victor Adossi <123968127+vados-cosmonic@users.noreply.github.com>

Be more specific re: module v component and use wasip2 target

3fb77a6

Update based on further review comments

21c00b7

tpmccallum requested a review from vados-cosmonic April 14, 2025 07:02

pchickey approved these changes Apr 14, 2025

View reviewed changes

vados-cosmonic approved these changes Apr 15, 2025

View reviewed changes

tpmccallum added 2 commits April 15, 2025 10:44

Update to use best practice of interface in the WIT file, as per revi…

9324368

…ew comment.

Final pass - couple of tweaks. Ready to publish.

84c865c

vados-cosmonic mentioned this pull request Apr 23, 2025

fix(docs): remove $ from console commands for easy copy/paste bytecodealliance/wasmtime#10653

Merged

tpmccallum changed the title ~~Adding draft article re: wasmtime run --invoke~~ blog: Running Wasm Components From the Command Line (approved) Apr 24, 2025

tpmccallum added 2 commits April 24, 2025 14:56

Update publish date

aaa08ac

Just setting the `date` frontmatter to a future publishing date.

Update the article's publish date in the filename

a2b3d53

pchickey requested changes Apr 25, 2025

View reviewed changes

Rename and update article for v33.0.0 release

cb41248

tpmccallum requested a review from pchickey April 29, 2025 22:17

pchickey approved these changes Apr 30, 2025

View reviewed changes

abrown approved these changes May 6, 2025

View reviewed changes

ospencer approved these changes May 6, 2025

View reviewed changes

abrown merged commit 25263d4 into bytecodealliance:gh-pages May 21, 2025

Comments

Conversation

tpmccallum commented Apr 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

vados-cosmonic left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

vados-cosmonic left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

pchickey left a comment

Choose a reason for hiding this comment

Uh oh!

vados-cosmonic left a comment

Choose a reason for hiding this comment

Uh oh!

tpmccallum commented Apr 15, 2025

Uh oh!

vados-cosmonic commented Apr 15, 2025

Uh oh!

pchickey left a comment

Choose a reason for hiding this comment

Uh oh!

pchickey Apr 25, 2025

Choose a reason for hiding this comment

Uh oh!

tpmccallum Apr 29, 2025

Choose a reason for hiding this comment

Uh oh!

abrown Apr 30, 2025

Choose a reason for hiding this comment

Uh oh!

abrown left a comment

Choose a reason for hiding this comment

Uh oh!

ospencer left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

tpmccallum commented Apr 4, 2025 •

edited

Loading