wasmer/src/webassembly.rs

108 lines
3.5 KiB
Rust
Raw Normal View History

2019-01-24 06:00:38 +00:00
use std::panic;
use wasmer_runtime::{
self as runtime,
2019-01-18 19:15:13 +00:00
error::{CallResult, Result},
ImportObject, Instance, Module,
};
2019-03-27 21:01:27 +00:00
use wasmer_runtime_core::backend::CompilerConfig;
use wasmer_runtime_core::types::Value;
use wasmer_emscripten::{is_emscripten_module, run_emscripten_instance};
pub struct ResultObject {
/// A webassembly::Module object representing the compiled WebAssembly module.
/// This Module can be instantiated again
pub module: Module,
/// A webassembly::Instance object that contains all the Exported WebAssembly
/// functions.
2018-12-30 10:23:16 +00:00
pub instance: Box<Instance>,
}
2019-01-10 01:45:48 +00:00
#[derive(PartialEq)]
pub enum InstanceABI {
Emscripten,
None,
}
/// The webassembly::instantiate() function allows you to compile and
/// instantiate WebAssembly code
2018-10-14 21:48:59 +00:00
/// Params:
/// * `buffer_source`: A `Vec<u8>` containing the
/// binary code of the .wasm module you want to compile.
/// * `import_object`: An object containing the values to be imported
/// into the newly-created Instance, such as functions or
/// webassembly::Memory objects. There must be one matching property
/// for each declared import of the compiled module or else a
/// webassembly::LinkError is thrown.
/// Errors:
2018-10-14 21:48:59 +00:00
/// If the operation fails, the Result rejects with a
/// webassembly::CompileError, webassembly::LinkError, or
/// webassembly::RuntimeError, depending on the cause of the failure.
pub fn instantiate(buffer_source: &[u8], import_object: ImportObject) -> Result<ResultObject> {
2019-01-19 06:28:41 +00:00
debug!("webassembly - compiling module");
let module = compile(&buffer_source[..])?;
debug!("webassembly - instantiating");
2019-03-27 21:01:27 +00:00
let instance = module.instantiate(&import_object)?;
2019-01-19 06:28:41 +00:00
debug!("webassembly - instance created");
Ok(ResultObject {
module,
instance: Box::new(instance),
})
}
2018-10-24 10:36:43 +00:00
/// The webassembly::instantiate_streaming() function compiles and instantiates
/// a WebAssembly module directly from a streamed underlying source.
/// This is the most efficient, optimized way to load wasm code.
2018-10-24 10:36:43 +00:00
pub fn instantiate_streaming(
2018-11-06 14:51:01 +00:00
_buffer_source: Vec<u8>,
_import_object: ImportObject,
) -> Result<ResultObject> {
unimplemented!();
}
/// The webassembly::compile() function compiles a webassembly::Module
/// from WebAssembly binary code. This function is useful if it
/// is necessary to a compile a module before it can be instantiated
/// (otherwise, the webassembly::instantiate() function should be used).
2018-10-14 21:48:59 +00:00
/// Params:
/// * `buffer_source`: A `Vec<u8>` containing the
/// binary code of the .wasm module you want to compile.
/// Errors:
2018-10-14 21:48:59 +00:00
/// If the operation fails, the Result rejects with a
/// webassembly::CompileError.
pub fn compile(buffer_source: &[u8]) -> Result<Module> {
let module = runtime::compile(buffer_source)?;
Ok(module)
}
2018-12-11 00:23:14 +00:00
2019-03-27 21:01:27 +00:00
pub fn compile_with_config(
buffer_source: &[u8],
compiler_config: CompilerConfig,
) -> Result<Module> {
let module = runtime::compile_with_config(buffer_source, compiler_config)?;
Ok(module)
}
2019-01-19 06:28:41 +00:00
/// Performs common instance operations needed when an instance is first run
/// including data setup, handling arguments and calling a main function
pub fn run_instance(
module: &Module,
2018-12-15 06:46:11 +00:00
instance: &mut Instance,
path: &str,
2019-01-23 21:29:51 +00:00
args: Vec<&str>,
) -> CallResult<()> {
if is_emscripten_module(module) {
2019-01-24 06:00:38 +00:00
run_emscripten_instance(module, instance, path, args)?;
2018-12-11 00:23:14 +00:00
} else {
2019-03-17 16:35:55 +00:00
let args: Vec<Value> = args
.into_iter()
.map(|x| Value::I32(x.parse().unwrap()))
.collect();
2019-03-18 08:08:43 +00:00
instance.call("main", &args)?;
2018-12-30 10:23:16 +00:00
};
Ok(())
2018-12-11 00:23:14 +00:00
}