92ba4929e5
This drops the text format (%.wat) and renames InstantiateModuleFromCode to InstantiateModuleFromBinary as it is no longer ambiguous. We decided to stop supporting the text format as it isn't typically used in production, yet costs a lot of work to develop. Given the resources available and the increased work added with WebAssembly 2.0 and soon WASI 2, we can't afford to spend the time on it. The old parser is used only internally and will eventually be moved to its own repository named watzero, possibly towards archival. See #59 Signed-off-by: Adrian Cole <adrian@tetrate.io>
Rust allocation example
This example shows how to pass strings in and out of a Wasm function defined
in Rust, built with cargo build --release --target wasm32-unknown-unknown
Ex.
$ go run greet.go wazero
Hello, wazero!
Under the covers, lib.rs does a few things of interest:
- Uses a WebAssembly-tuned memory allocator: wee_alloc.
- Exports wrapper functions to allocate and deallocate memory.
- Uses
&strinstead of CString (NUL-terminated strings). - Uses
std::mem::forgetto prevent Rust from eagerly freeing pointers returned.
Note: We chose to not use CString because it keeps the example similar to how you would track memory for arbitrary blobs. We also watched function signatures carefully as Rust compiles different WebAssembly signatures depending on the input type. All of this is Rust-specific, and wazero isn't a Rust project, but we hope this gets you started. For next steps, consider reading the Rust and WebAssembly book.