4th iteration on documentation (#22)

* Rename LoadedModule to Module

* Hide TryInto

* Fix rustdoc tests.

* Rename from_parity_wasm_module and doc it.

* Document `Module::from_buffer`

* Tidy Module docs

* Some rustdoc headers.

* Document FuncInstance::{alloc_host, signature}

* Document descriptors.

* Doc NotStartedModuleRef

* Fix cargo-deadlinks
This commit is contained in:
Sergey Pepyakin 2018-01-26 19:24:40 +03:00 committed by GitHub
parent aa4c8fe3bb
commit 551c992730
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
15 changed files with 179 additions and 75 deletions

View File

@ -12,7 +12,8 @@ addons:
- g++-6 - g++-6
- cmake - cmake
install: install:
- cargo install cargo-deadlinks # Install `cargo-deadlinks` unless it is currently installed.
- command -v cargo-deadlinks &> /dev/null || cargo install cargo-deadlinks
script: script:
- export CC=/usr/bin/gcc-6 - export CC=/usr/bin/gcc-6
- export CXX=/usr/bin/g++-6 - export CXX=/usr/bin/g++-6

View File

@ -4,14 +4,14 @@ extern crate wasmi;
use std::env::args; use std::env::args;
use std::fs::File; use std::fs::File;
use wasmi::{ModuleInstance, NopExternals, RuntimeValue, ImportsBuilder, load_from_buffer, LoadedModule}; use wasmi::{ModuleInstance, NopExternals, RuntimeValue, ImportsBuilder, Module};
fn load_from_file(filename: &str) -> LoadedModule { fn load_from_file(filename: &str) -> Module {
use std::io::prelude::*; use std::io::prelude::*;
let mut file = File::open(filename).unwrap(); let mut file = File::open(filename).unwrap();
let mut buf = Vec::new(); let mut buf = Vec::new();
file.read_to_end(&mut buf).unwrap(); file.read_to_end(&mut buf).unwrap();
load_from_buffer(buf).unwrap() Module::from_buffer(buf).unwrap()
} }
fn main() { fn main() {

View File

@ -4,7 +4,7 @@ extern crate wasmi;
use std::env::args; use std::env::args;
use parity_wasm::elements::{Internal, External, Type, FunctionType, ValueType}; use parity_wasm::elements::{Internal, External, Type, FunctionType, ValueType};
use wasmi::{RuntimeValue, ModuleInstance, NopExternals, ImportsBuilder, load_from_module}; use wasmi::{RuntimeValue, ModuleInstance, NopExternals, ImportsBuilder};
fn main() { fn main() {
@ -69,7 +69,7 @@ fn main() {
}).collect::<Vec<RuntimeValue>>() }).collect::<Vec<RuntimeValue>>()
}; };
let loaded_module = load_from_module(module).expect("Module to be valid"); let loaded_module = wasmi::Module::from_parity_wasm_module(module).expect("Module to be valid");
// Intialize deserialized module. It adds module into It expects 3 parameters: // Intialize deserialized module. It adds module into It expects 3 parameters:
// - a name for the module // - a name for the module

View File

@ -195,7 +195,7 @@ fn instantiate(path: &str) -> Result<ModuleRef, Error> {
let mut file = File::open(path).unwrap(); let mut file = File::open(path).unwrap();
let mut wasm_buf = Vec::new(); let mut wasm_buf = Vec::new();
file.read_to_end(&mut wasm_buf).unwrap(); file.read_to_end(&mut wasm_buf).unwrap();
wasmi::load_from_buffer(&wasm_buf)? wasmi::Module::from_buffer(&wasm_buf)?
}; };
let mut imports = ImportsBuilder::new(); let mut imports = ImportsBuilder::new();

View File

@ -13,7 +13,7 @@ use wasmi::{
GlobalInstance, GlobalRef, ImportResolver, ImportsBuilder, GlobalInstance, GlobalRef, ImportResolver, ImportsBuilder,
MemoryInstance, MemoryRef, ModuleImportResolver, ModuleInstance, MemoryInstance, MemoryRef, ModuleImportResolver, ModuleInstance,
ModuleRef, RuntimeValue, TableInstance, TableRef, ValueType, ModuleRef, RuntimeValue, TableInstance, TableRef, ValueType,
load_from_buffer, LoadedModule, Signature, MemoryDescriptor, Module, Signature, MemoryDescriptor,
TableDescriptor, GlobalDescriptor, FuncInstance, RuntimeArgs, TableDescriptor, GlobalDescriptor, FuncInstance, RuntimeArgs,
}; };
@ -225,7 +225,7 @@ impl ImportResolver for SpecDriver {
} }
} }
fn try_load_module(base_dir: &Path, module_path: &str) -> Result<LoadedModule, Error> { fn try_load_module(base_dir: &Path, module_path: &str) -> Result<Module, Error> {
use std::io::prelude::*; use std::io::prelude::*;
let mut wasm_path = PathBuf::from(base_dir.clone()); let mut wasm_path = PathBuf::from(base_dir.clone());
@ -233,7 +233,7 @@ fn try_load_module(base_dir: &Path, module_path: &str) -> Result<LoadedModule, E
let mut file = File::open(wasm_path).unwrap(); let mut file = File::open(wasm_path).unwrap();
let mut buf = Vec::new(); let mut buf = Vec::new();
file.read_to_end(&mut buf).unwrap(); file.read_to_end(&mut buf).unwrap();
load_from_buffer(buf).map_err(|e| Error::Load(e.to_string())) Module::from_buffer(buf).map_err(|e| Error::Load(e.to_string()))
} }
fn try_load( fn try_load(

View File

@ -10,7 +10,7 @@ use module::ModuleInstance;
use common::stack::StackWithLimit; use common::stack::StackWithLimit;
use common::{DEFAULT_FRAME_STACK_LIMIT, DEFAULT_VALUE_STACK_LIMIT}; use common::{DEFAULT_FRAME_STACK_LIMIT, DEFAULT_VALUE_STACK_LIMIT};
/// Reference to a [`FuncInstance`]. /// Reference to a function (See [`FuncInstance`] for details).
/// ///
/// This reference has a reference-counting semantics. /// This reference has a reference-counting semantics.
/// ///
@ -77,6 +77,15 @@ impl fmt::Debug for FuncInstance {
} }
impl FuncInstance { impl FuncInstance {
/// Allocate a function instance for a host function.
///
/// When this function instance will be called by the wasm code,
/// the instance of [`Externals`] will be invoked by calling `invoke_index`
/// with specified `host_func_index` here.
/// This call will be made with the `signature` provided here.
///
/// [`Externals`]: trait.Externals.html
pub fn alloc_host(signature: Signature, host_func_index: usize) -> FuncRef { pub fn alloc_host(signature: Signature, host_func_index: usize) -> FuncRef {
let func = FuncInstanceInternal::Host { let func = FuncInstanceInternal::Host {
signature, signature,
@ -85,6 +94,18 @@ impl FuncInstance {
FuncRef(Rc::new(FuncInstance(func))) FuncRef(Rc::new(FuncInstance(func)))
} }
/// Returns [signature] of this function instance.
///
/// This function instance can only be called with matching signatures.
///
/// [signature]: struct.Signature.html
pub fn signature(&self) -> &Signature {
match *self.as_internal() {
FuncInstanceInternal::Internal { ref signature, .. } => signature,
FuncInstanceInternal::Host { ref signature, .. } => signature,
}
}
pub(crate) fn as_internal(&self) -> &FuncInstanceInternal { pub(crate) fn as_internal(&self) -> &FuncInstanceInternal {
&self.0 &self.0
} }
@ -102,13 +123,6 @@ impl FuncInstance {
FuncRef(Rc::new(FuncInstance(func))) FuncRef(Rc::new(FuncInstance(func)))
} }
pub fn signature(&self) -> &Signature {
match *self.as_internal() {
FuncInstanceInternal::Internal { ref signature, .. } => signature,
FuncInstanceInternal::Host { ref signature, .. } => signature,
}
}
pub(crate) fn body(&self) -> Option<Rc<FuncBody>> { pub(crate) fn body(&self) -> Option<Rc<FuncBody>> {
match *self.as_internal() { match *self.as_internal() {
FuncInstanceInternal::Internal { ref body, .. } => Some(Rc::clone(body)), FuncInstanceInternal::Internal { ref body, .. } => Some(Rc::clone(body)),

View File

@ -5,7 +5,7 @@ use Error;
use types::ValueType; use types::ValueType;
use parity_wasm::elements::{ValueType as EValueType}; use parity_wasm::elements::{ValueType as EValueType};
/// Reference to a [`GlobalInstance`]. /// Reference to a global variable (See [`GlobalInstance`] for details).
/// ///
/// This reference has a reference-counting semantics. /// This reference has a reference-counting semantics.
/// ///

View File

@ -80,12 +80,12 @@ pub trait ImportResolver {
/// # Examples /// # Examples
/// ///
/// ```rust /// ```rust
/// use wasmi::{load_from_buffer, ModuleInstance, ImportsBuilder}; /// use wasmi::{ModuleInstance, ImportsBuilder};
/// # /// #
/// # struct EnvModuleResolver; /// # struct EnvModuleResolver;
/// # impl ::wasmi::ModuleImportResolver for EnvModuleResolver { } /// # impl ::wasmi::ModuleImportResolver for EnvModuleResolver { }
/// # fn func() -> Result<(), ::wasmi::Error> { /// # fn func() -> Result<(), ::wasmi::Error> {
/// # let module = load_from_buffer(&[0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]).unwrap(); /// # let module = wasmi::Module::from_buffer(&[0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]).unwrap();
/// # let other_instance = ModuleInstance::new(&module, &ImportsBuilder::default())?.assert_no_start(); /// # let other_instance = ModuleInstance::new(&module, &ImportsBuilder::default())?.assert_no_start();
/// ///
/// let imports = ImportsBuilder::new() /// let imports = ImportsBuilder::new()

View File

@ -68,7 +68,7 @@
//! .expect("failed to parse wat"); //! .expect("failed to parse wat");
//! //!
//! // Load wasm binary and prepare it for instantiation. //! // Load wasm binary and prepare it for instantiation.
//! let module = wasmi::load_from_buffer(&wasm_binary) //! let module = wasmi::Module::from_buffer(&wasm_binary)
//! .expect("failed to load wasm"); //! .expect("failed to load wasm");
//! //!
//! // Instantiate a module with empty imports and //! // Instantiate a module with empty imports and
@ -105,7 +105,6 @@ extern crate byteorder;
use std::fmt; use std::fmt;
use std::error; use std::error;
use std::collections::HashMap; use std::collections::HashMap;
use parity_wasm::elements::Module;
/// Internal interpreter error. /// Internal interpreter error.
#[derive(Debug)] #[derive(Debug)]
@ -223,7 +222,7 @@ mod tests;
pub use self::memory::{MemoryInstance, MemoryRef}; pub use self::memory::{MemoryInstance, MemoryRef};
pub use self::table::{TableInstance, TableRef}; pub use self::table::{TableInstance, TableRef};
pub use self::value::{RuntimeValue, TryInto}; pub use self::value::RuntimeValue;
pub use self::host::{Externals, NopExternals, HostError, RuntimeArgs}; pub use self::host::{Externals, NopExternals, HostError, RuntimeArgs};
pub use self::imports::{ModuleImportResolver, ImportResolver, ImportsBuilder}; pub use self::imports::{ModuleImportResolver, ImportResolver, ImportsBuilder};
pub use self::module::{ModuleInstance, ModuleRef, ExternVal, NotStartedModuleRef}; pub use self::module::{ModuleInstance, ModuleRef, ExternVal, NotStartedModuleRef};
@ -231,40 +230,96 @@ pub use self::global::{GlobalInstance, GlobalRef};
pub use self::func::{FuncInstance, FuncRef}; pub use self::func::{FuncInstance, FuncRef};
pub use self::types::{Signature, ValueType, GlobalDescriptor, TableDescriptor, MemoryDescriptor}; pub use self::types::{Signature, ValueType, GlobalDescriptor, TableDescriptor, MemoryDescriptor};
pub struct LoadedModule { /// Deserialized module prepared for instantiation.
pub struct Module {
labels: HashMap<usize, HashMap<usize, usize>>, labels: HashMap<usize, HashMap<usize, usize>>,
module: Module, module: parity_wasm::elements::Module,
} }
impl LoadedModule { impl Module {
pub(crate) fn module(&self) -> &Module {
&self.module
}
pub(crate) fn labels(&self) -> &HashMap<usize, HashMap<usize, usize>> { /// Create `Module` from `parity_wasm::elements::Module`.
&self.labels ///
} /// This function will load, validate and prepare a `parity_wasm`'s `Module`.
///
pub fn into_module(self) -> Module { /// # Errors
self.module ///
} /// Returns `Err` if provided `Module` is not valid.
} ///
/// # Examples
pub fn load_from_module(module: Module) -> Result<LoadedModule, Error> { ///
/// ```rust
/// extern crate parity_wasm;
/// extern crate wasmi;
///
/// use parity_wasm::builder;
/// use parity_wasm::elements;
///
/// fn main() {
/// let parity_module =
/// builder::module()
/// .function()
/// .signature().with_param(elements::ValueType::I32).build()
/// .body().build()
/// .build()
/// .build();
///
/// let module = wasmi::Module::from_parity_wasm_module(parity_module)
/// .expect("parity-wasm builder generated invalid module!");
///
/// // Instantiate `module`, etc...
/// }
/// ```
pub fn from_parity_wasm_module(module: parity_wasm::elements::Module) -> Result<Module, Error> {
use validation::{validate_module, ValidatedModule}; use validation::{validate_module, ValidatedModule};
let ValidatedModule { let ValidatedModule {
labels, labels,
module, module,
} = validate_module(module)?; } = validate_module(module)?;
Ok(LoadedModule { Ok(Module {
labels, labels,
module, module,
}) })
} }
pub fn load_from_buffer<B: AsRef<[u8]>>(buffer: B) -> Result<LoadedModule, Error> { /// Create `Module` from a given buffer.
///
/// This function will deserialize wasm module from a given module,
/// validate and prepare it for instantiation.
///
/// # Errors
///
/// Returns `Err` if wasm binary in provided `buffer` is not valid wasm binary.
///
/// # Examples
///
/// ```rust
/// extern crate wasmi;
///
/// fn main() {
/// let module =
/// wasmi::Module::from_buffer(
/// // Minimal module:
/// // \0asm - magic
/// // 0x01 - version (in little-endian)
/// &[0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]
/// ).expect("Failed to load minimal module");
///
/// // Instantiate `module`, etc...
/// }
/// ```
pub fn from_buffer<B: AsRef<[u8]>>(buffer: B) -> Result<Module, Error> {
let module = parity_wasm::elements::deserialize_buffer(buffer.as_ref()) let module = parity_wasm::elements::deserialize_buffer(buffer.as_ref())
.map_err(|e: parity_wasm::elements::Error| Error::Validation(e.to_string()))?; .map_err(|e: parity_wasm::elements::Error| Error::Validation(e.to_string()))?;
load_from_module(module) Module::from_parity_wasm_module(module)
}
pub(crate) fn module(&self) -> &parity_wasm::elements::Module {
&self.module
}
pub(crate) fn labels(&self) -> &HashMap<usize, HashMap<usize, usize>> {
&self.labels
}
} }

View File

@ -13,7 +13,7 @@ pub const LINEAR_MEMORY_PAGE_SIZE: u32 = 65536;
/// Maximal number of pages. /// Maximal number of pages.
const LINEAR_MEMORY_MAX_PAGES: u32 = 65536; const LINEAR_MEMORY_MAX_PAGES: u32 = 65536;
/// Reference to a [`MemoryInstance`]. /// Reference to a memory (See [`MemoryInstance`] for details).
/// ///
/// This reference has a reference-counting semantics. /// This reference has a reference-counting semantics.
/// ///

View File

@ -3,7 +3,7 @@ use std::cell::RefCell;
use std::fmt; use std::fmt;
use std::collections::HashMap; use std::collections::HashMap;
use parity_wasm::elements::{External, InitExpr, Internal, Opcode, ResizableLimits, Type}; use parity_wasm::elements::{External, InitExpr, Internal, Opcode, ResizableLimits, Type};
use {LoadedModule, Error, Signature, MemoryInstance, RuntimeValue, TableInstance}; use {Module, Error, Signature, MemoryInstance, RuntimeValue, TableInstance};
use imports::ImportResolver; use imports::ImportResolver;
use global::{GlobalInstance, GlobalRef}; use global::{GlobalInstance, GlobalRef};
use func::{FuncRef, FuncBody, FuncInstance}; use func::{FuncRef, FuncBody, FuncInstance};
@ -100,9 +100,9 @@ impl ExternVal {
} }
} }
/// A module instance is the runtime representation of a [module][`LoadedModule`]. /// A module instance is the runtime representation of a [module][`Module`].
/// ///
/// It is created by instantiating a [module][`LoadedModule`], and collects runtime representations /// It is created by instantiating a [module][`Module`], and collects runtime representations
/// of all entities that are imported or defined by the module, namely: /// of all entities that are imported or defined by the module, namely:
/// ///
/// - [functions][`FuncInstance`], /// - [functions][`FuncInstance`],
@ -115,7 +115,7 @@ impl ExternVal {
/// ///
/// After module is instantiated you can start invoking it's exported functions with [`invoke_export`]. /// After module is instantiated you can start invoking it's exported functions with [`invoke_export`].
/// ///
/// [`LoadedModule`]: struct.LoadedModule.html /// [`Module`]: struct.Module.html
/// [`FuncInstance`]: struct.FuncInstance.html /// [`FuncInstance`]: struct.FuncInstance.html
/// [`MemoryInstance`]: struct.MemoryInstance.html /// [`MemoryInstance`]: struct.MemoryInstance.html
/// [`TableInstance`]: struct.TableInstance.html /// [`TableInstance`]: struct.TableInstance.html
@ -188,7 +188,7 @@ impl ModuleInstance {
} }
fn alloc_module( fn alloc_module(
loaded_module: &LoadedModule, loaded_module: &Module,
extern_vals: &[ExternVal] extern_vals: &[ExternVal]
) -> Result<ModuleRef, Error> { ) -> Result<ModuleRef, Error> {
let module = loaded_module.module(); let module = loaded_module.module();
@ -357,7 +357,7 @@ impl ModuleInstance {
} }
fn instantiate_with_externvals( fn instantiate_with_externvals(
loaded_module: &LoadedModule, loaded_module: &Module,
extern_vals: &[ExternVal], extern_vals: &[ExternVal],
) -> Result<ModuleRef, Error> { ) -> Result<ModuleRef, Error> {
let module = loaded_module.module(); let module = loaded_module.module();
@ -400,7 +400,7 @@ impl ModuleInstance {
Ok(module_ref) Ok(module_ref)
} }
/// Instantiate a [module][`LoadedModule`]. /// Instantiate a [module][`Module`].
/// ///
/// Note that in case of successful instantiation this function returns a reference to /// Note that in case of successful instantiation this function returns a reference to
/// a module which `start` function is not called. /// a module which `start` function is not called.
@ -408,6 +408,8 @@ impl ModuleInstance {
/// situations where you might need to do additional setup before calling `start` function. /// situations where you might need to do additional setup before calling `start` function.
/// For such sitations this separation might be useful. /// For such sitations this separation might be useful.
/// ///
/// See [`NotStartedModuleRef`] for details.
///
/// # Errors /// # Errors
/// ///
/// Returns `Err` if the module cannot be instantiated. /// Returns `Err` if the module cannot be instantiated.
@ -420,9 +422,9 @@ impl ModuleInstance {
/// # Examples /// # Examples
/// ///
/// ```rust /// ```rust
/// use wasmi::{load_from_buffer, ModuleInstance, ImportsBuilder, NopExternals}; /// use wasmi::{ModuleInstance, ImportsBuilder, NopExternals};
/// # fn func() -> Result<(), ::wasmi::Error> { /// # fn func() -> Result<(), ::wasmi::Error> {
/// # let module = load_from_buffer(&[0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]).unwrap(); /// # let module = wasmi::Module::from_buffer(&[0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]).unwrap();
/// ///
/// // ModuleInstance::new returns instance which `start` function isn't called. /// // ModuleInstance::new returns instance which `start` function isn't called.
/// let not_started = ModuleInstance::new( /// let not_started = ModuleInstance::new(
@ -440,9 +442,9 @@ impl ModuleInstance {
/// instantiated module without calling `start` function. /// instantiated module without calling `start` function.
/// ///
/// ```rust /// ```rust
/// use wasmi::{load_from_buffer, ModuleInstance, ImportsBuilder, NopExternals}; /// use wasmi::{ModuleInstance, ImportsBuilder, NopExternals};
/// # fn func() -> Result<(), ::wasmi::Error> { /// # fn func() -> Result<(), ::wasmi::Error> {
/// # let module = load_from_buffer(&[0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]).unwrap(); /// # let module = wasmi::Module::from_buffer(&[0x00, 0x61, 0x73, 0x6d, 0x01, 0x00, 0x00, 0x00]).unwrap();
/// ///
/// // This will panic if the module actually contain `start` function. /// // This will panic if the module actually contain `start` function.
/// let not_started = ModuleInstance::new( /// let not_started = ModuleInstance::new(
@ -454,11 +456,12 @@ impl ModuleInstance {
/// # } /// # }
/// ``` /// ```
/// ///
/// [`LoadedModule`]: struct.LoadedModule.html /// [`Module`]: struct.Module.html
/// [`NotStartedModuleRef`]: struct.NotStartedModuleRef.html
/// [`ImportResolver`]: trait.ImportResolver.html /// [`ImportResolver`]: trait.ImportResolver.html
/// [`assert_no_start`]: struct.NotStartedModuleRef.html#method.assert_no_start /// [`assert_no_start`]: struct.NotStartedModuleRef.html#method.assert_no_start
pub fn new<'m, I: ImportResolver>( pub fn new<'m, I: ImportResolver>(
loaded_module: &'m LoadedModule, loaded_module: &'m Module,
imports: &I, imports: &I,
) -> Result<NotStartedModuleRef<'m>, Error> { ) -> Result<NotStartedModuleRef<'m>, Error> {
let module = loaded_module.module(); let module = loaded_module.module();
@ -536,7 +539,7 @@ impl ModuleInstance {
/// # ) /// # )
/// # "#, /// # "#,
/// # ).expect("failed to parse wat"); /// # ).expect("failed to parse wat");
/// # let module = wasmi::load_from_buffer(&wasm_binary).expect("failed to load wasm"); /// # let module = wasmi::Module::from_buffer(&wasm_binary).expect("failed to load wasm");
/// # let instance = ModuleInstance::new( /// # let instance = ModuleInstance::new(
/// # &module, /// # &module,
/// # &ImportsBuilder::default() /// # &ImportsBuilder::default()
@ -583,8 +586,20 @@ impl ModuleInstance {
} }
} }
/// Mostly instantiated [`ModuleRef`].
///
/// The last step of instantiation is call to `start` function (if any).
/// To get [fully instantiated module instance][`ModuleRef`], [running `start` function][`run_start`] is required.
///
/// If you sure, that there is no `start` function (e.g. because you created it without one), you can
/// call [`assert_no_start`] which returns [`ModuleRef`] without calling `start` function. However,
/// it will panic if module contains `start` function.
///
/// [`ModuleRef`]: struct.ModuleRef.html
/// [`run_start`]: #method.run_start
/// [`assert_no_start`]: #method.assert_no_start
pub struct NotStartedModuleRef<'a> { pub struct NotStartedModuleRef<'a> {
loaded_module: &'a LoadedModule, loaded_module: &'a Module,
instance: ModuleRef, instance: ModuleRef,
} }

View File

@ -7,7 +7,7 @@ use Error;
use func::FuncRef; use func::FuncRef;
use module::check_limits; use module::check_limits;
/// Reference to a [`TableInstance`]. /// Reference to a table (See [`TableInstance`] for details).
/// ///
/// This reference has a reference-counting semantics. /// This reference has a reference-counting semantics.
/// ///

View File

@ -1,7 +1,7 @@
use { use {
Error, Signature, Externals, FuncInstance, FuncRef, HostError, ImportsBuilder, Error, Signature, Externals, FuncInstance, FuncRef, HostError, ImportsBuilder,
MemoryInstance, MemoryRef, TableInstance, TableRef, ModuleImportResolver, ModuleInstance, ModuleRef, MemoryInstance, MemoryRef, TableInstance, TableRef, ModuleImportResolver, ModuleInstance, ModuleRef,
RuntimeValue, RuntimeArgs, LoadedModule, load_from_buffer, TableDescriptor, MemoryDescriptor, RuntimeValue, RuntimeArgs, Module, TableDescriptor, MemoryDescriptor,
}; };
use types::ValueType; use types::ValueType;
use wabt::wat2wasm; use wabt::wat2wasm;
@ -200,9 +200,9 @@ impl ModuleImportResolver for TestHost {
} }
} }
fn parse_wat(source: &str) -> LoadedModule { fn parse_wat(source: &str) -> Module {
let wasm_binary = wat2wasm(source).expect("Failed to parse wat source"); let wasm_binary = wat2wasm(source).expect("Failed to parse wat source");
load_from_buffer(wasm_binary).expect("Failed to load parsed module") Module::from_buffer(wasm_binary).expect("Failed to load parsed module")
} }
#[test] #[test]

View File

@ -1,7 +1,7 @@
use { use {
Error, Signature, FuncRef, GlobalInstance, GlobalRef, ImportsBuilder, MemoryInstance, Error, Signature, FuncRef, GlobalInstance, GlobalRef, ImportsBuilder, MemoryInstance,
MemoryRef, ModuleImportResolver, ModuleInstance, NopExternals, RuntimeValue, MemoryRef, ModuleImportResolver, ModuleInstance, NopExternals, RuntimeValue,
TableInstance, TableRef, LoadedModule, load_from_buffer, GlobalDescriptor, TableDescriptor, MemoryDescriptor, TableInstance, TableRef, Module, GlobalDescriptor, TableDescriptor, MemoryDescriptor,
}; };
use std::fs::File; use std::fs::File;
@ -69,12 +69,12 @@ impl ModuleImportResolver for Env {
} }
} }
fn load_from_file(filename: &str) -> LoadedModule { fn load_from_file(filename: &str) -> Module {
use std::io::prelude::*; use std::io::prelude::*;
let mut file = File::open(filename).unwrap(); let mut file = File::open(filename).unwrap();
let mut buf = Vec::new(); let mut buf = Vec::new();
file.read_to_end(&mut buf).unwrap(); file.read_to_end(&mut buf).unwrap();
load_from_buffer(buf).unwrap() Module::from_buffer(buf).unwrap()
} }
#[test] #[test]

View File

@ -3,13 +3,14 @@ use std::borrow::Cow;
use parity_wasm::elements::{ use parity_wasm::elements::{
FunctionType, ValueType as EValueType, GlobalType, TableType, MemoryType}; FunctionType, ValueType as EValueType, GlobalType, TableType, MemoryType};
/// Signature of a function. /// Signature of a [function].
/// ///
/// Signature of a function consists of zero or more parameter [types][type] and zero or one return [type]. /// Signature of a function consists of zero or more parameter [types][type] and zero or one return [type].
/// ///
/// Two signatures are considered equal if they have equal list of parameters and equal return types. /// Two signatures are considered equal if they have equal list of parameters and equal return types.
/// ///
/// [type]: enum.ValueType.html /// [type]: enum.ValueType.html
/// [function]: struct.FuncInstance.html
#[derive(Debug, Clone, PartialEq, Eq)] #[derive(Debug, Clone, PartialEq, Eq)]
pub struct Signature { pub struct Signature {
params: Cow<'static, [ValueType]>, params: Cow<'static, [ValueType]>,
@ -79,6 +80,12 @@ impl ValueType {
} }
} }
/// Description of a global variable.
///
/// Primarly used to describe imports of global variables.
/// See [`ImportResolver`] for details.
///
/// [`ImportResolver`]: trait.ImportResolver.html
pub struct GlobalDescriptor { pub struct GlobalDescriptor {
value_type: ValueType, value_type: ValueType,
mutable: bool, mutable: bool,
@ -101,6 +108,12 @@ impl GlobalDescriptor {
} }
} }
/// Description of a table.
///
/// Primarly used to describe imports of tables.
/// See [`ImportResolver`] for details.
///
/// [`ImportResolver`]: trait.ImportResolver.html
pub struct TableDescriptor { pub struct TableDescriptor {
initial: u32, initial: u32,
maximum: Option<u32>, maximum: Option<u32>,
@ -123,6 +136,12 @@ impl TableDescriptor {
} }
} }
/// Description of a linear memory.
///
/// Primarly used to describe imports of linear memories.
/// See [`ImportResolver`] for details.
///
/// [`ImportResolver`]: trait.ImportResolver.html
pub struct MemoryDescriptor { pub struct MemoryDescriptor {
initial: u32, initial: u32,
maximum: Option<u32>, maximum: Option<u32>,