b9dc38f4e1
This commit removes the need to use `HostRef<Engine>` in the Rust API. Usage is retained in the C API in one location, but otherwise `Engine` can always be used directly. This is the first step of progress on #708 for the `Engine` type. Changes here include: * `Engine` is now `Clone`, and is documented as being cheap. It's not intended that cloning an engine creates a deep copy. * `Engine` is now both `Send` and `Sync`, and asserted to be so. * Usage of `Engine` in APIs no longer requires or uses `HostRef`.
70 lines
2.5 KiB
Rust
70 lines
2.5 KiB
Rust
//! Translation of hello example
|
|
|
|
use anyhow::{ensure, format_err, Context as _, Result};
|
|
use std::rc::Rc;
|
|
use wasmtime::*;
|
|
|
|
struct HelloCallback;
|
|
|
|
impl Callable for HelloCallback {
|
|
fn call(&self, _params: &[Val], _results: &mut [Val]) -> Result<(), Trap> {
|
|
println!("Calling back...");
|
|
println!("> Hello World!");
|
|
Ok(())
|
|
}
|
|
}
|
|
|
|
fn main() -> Result<()> {
|
|
// Configure the initial compilation environment, creating more global
|
|
// structures such as an `Engine` and a `Store`.
|
|
println!("Initializing...");
|
|
let engine = Engine::default();
|
|
let store = HostRef::new(Store::new(&engine));
|
|
|
|
// Next upload the `*.wasm` binary file, which in this case we're going to
|
|
// be parsing an inline text format into a binary.
|
|
println!("Loading binary...");
|
|
let binary = wat::parse_str(
|
|
r#"
|
|
(module
|
|
(func $hello (import "" "hello"))
|
|
(func (export "run") (call $hello))
|
|
)
|
|
"#,
|
|
)?;
|
|
|
|
// Compiler the `*.wasm` binary into an in-memory instance of a `Module`.
|
|
println!("Compiling module...");
|
|
let module = HostRef::new(Module::new(&store, &binary).context("> Error compiling module!")?);
|
|
|
|
// Here we handle the imports of the module, which in this case is our
|
|
// `HelloCallback` type and its associated implementation of `Callback.
|
|
println!("Creating callback...");
|
|
let hello_type = FuncType::new(Box::new([]), Box::new([]));
|
|
let hello_func = HostRef::new(Func::new(&store, hello_type, Rc::new(HelloCallback)));
|
|
|
|
// Once we've got that all set up we can then move to the instantiation
|
|
// phase, pairing together a compiled module as well as a set of imports.
|
|
// Note that this is where the wasm `start` function, if any, would run.
|
|
println!("Instantiating module...");
|
|
let imports = vec![hello_func.into()];
|
|
let instance = Instance::new(&store, &module, imports.as_slice())
|
|
.context("> Error instantiating module!")?;
|
|
|
|
// Next we poke around a bit to extract the `run` function from the module.
|
|
println!("Extracting export...");
|
|
let exports = instance.exports();
|
|
ensure!(!exports.is_empty(), "> Error accessing exports!");
|
|
let run_func = exports[0].func().context("> Error accessing exports!")?;
|
|
|
|
// And last but not least we can call it!
|
|
println!("Calling export...");
|
|
run_func
|
|
.borrow()
|
|
.call(&[])
|
|
.map_err(|e| format_err!("> Error calling function: {:?}", e))?;
|
|
|
|
println!("Done.");
|
|
Ok(())
|
|
}
|