* Support parsing the text format in `wasmtime` crate This commit adds support to the `wasmtime::Module` type to parse the text format. This is often quite convenient to support in testing or tinkering with the runtime. Additionally the `wat` parser is pretty lightweight and easy to add to builds, so it's relatively easy for us to support as well! The exact manner that this is now supported comes with a few updates to the existing API: * A new optional feature of the `wasmtime` crate, `wat`, has been added. This is enabled by default. * The `Module::new` API now takes `impl AsRef<[u8]>` instead of just `&[u8]`, and when the `wat` feature is enabled it will attempt to interpret it either as a wasm binary or as the text format. Note that this check is quite cheap since you just check the first byte. * A `Module::from_file` API was added as a convenience to parse a file from disk, allowing error messages for `*.wat` files on disk to be a bit nicer. * APIs like `Module::new_unchecked` and `Module::validate` remain unchanged, they require the binary format to be called. The intention here is to make this as convenient as possible for new developers of the `wasmtime` crate. By changing the default behavior though this has ramifications such as, for example, supporting the text format implicitly through the C API now. * Handle review comments * Update more tests to avoid usage of `wat` crate * Go back to unchecked for now in wasm_module_new Looks like C# tests rely on this?
61 lines
1.4 KiB
Rust
61 lines
1.4 KiB
Rust
//! Example of instantiating of the WebAssembly module and
|
|
//! invoking its exported function.
|
|
|
|
use wasmtime::*;
|
|
|
|
const WAT: &str = r#"
|
|
(module
|
|
(func $gcd (param i32 i32) (result i32)
|
|
(local i32)
|
|
block ;; label = @1
|
|
block ;; label = @2
|
|
local.get 0
|
|
br_if 0 (;@2;)
|
|
local.get 1
|
|
local.set 2
|
|
br 1 (;@1;)
|
|
end
|
|
loop ;; label = @2
|
|
local.get 1
|
|
local.get 0
|
|
local.tee 2
|
|
i32.rem_u
|
|
local.set 0
|
|
local.get 2
|
|
local.set 1
|
|
local.get 0
|
|
br_if 0 (;@2;)
|
|
end
|
|
end
|
|
local.get 2
|
|
)
|
|
(export "gcd" (func $gcd))
|
|
)
|
|
"#;
|
|
|
|
fn main() -> anyhow::Result<()> {
|
|
// Load our WebAssembly (parsed WAT in our case), and then load it into a
|
|
// `Module` which is attached to a `Store` cache.
|
|
let store = Store::default();
|
|
let module = Module::new(&store, WAT)?;
|
|
|
|
// Find index of the `gcd` export.
|
|
let gcd_index = module
|
|
.exports()
|
|
.iter()
|
|
.enumerate()
|
|
.find(|(_, export)| export.name().to_string() == "gcd")
|
|
.unwrap()
|
|
.0;
|
|
|
|
// Instantiate the module.
|
|
let instance = Instance::new(&module, &[])?;
|
|
|
|
// Invoke `gcd` export
|
|
let gcd = instance.exports()[gcd_index].func().expect("gcd");
|
|
let result = gcd.call(&[Val::from(6i32), Val::from(27i32)])?;
|
|
|
|
println!("{:?}", result);
|
|
Ok(())
|
|
}
|