wazero

Files

Crypt Keeper d54008922c Redirects users to tested example (#791 )

Rather than clutter both the README and home page with details that can
drift and have caused maintenance, this directs users to the tested
basic example.

This also adds a FAQ entry about TinyGo's main, thanks to @basvanbeek
for the help.

Signed-off-by: Adrian Cole <adrian@tetrate.io>

2022-09-01 09:12:37 +08:00

testdata

Redirects users to tested example (#791 )

2022-09-01 09:12:37 +08:00

add_test.go

Redirects users to tested example (#791 )

2022-09-01 09:12:37 +08:00

add.go

Redirects users to tested example (#791 )

2022-09-01 09:12:37 +08:00

README.md

Redirects users to tested example (#791 )

2022-09-01 09:12:37 +08:00

README.md

Basic example

This example shows how to extend a Go application with an addition function defined in WebAssembly.

Ex.

$ go run add.go 7 9
7 + 9 = 16

Compilation

wazero is a WebAssembly runtime, embedded in your host application. To run WebAssembly functions, you need access to a WebAssembly Binary (Wasm), typically a %.wasm file.

add.wasm was compiled from add.go with TinyGo, as it is the most common way to compile Go source to Wasm. Here's the minimal command to build a %.wasm binary.

cd testdata; tinygo build -o add.wasm -target=wasi add.go

Notes

Many other languages compile to (target) Wasm including AssemblyScript, C, C++, Rust, and Zig!
The embedding application is often called the "host" in WebAssembly.
The Wasm binary is often called the "guest" in WebAssembly. Sometimes they need imports to implement features such as console output. TinyGo's wasi target, requires WASI imports.