mirror of
https://github.com/fluencelabs/wasmer
synced 2024-12-13 22:25:40 +00:00
120 lines
3.2 KiB
Rust
120 lines
3.2 KiB
Rust
#[cfg(test)]
|
|
#[macro_use]
|
|
extern crate field_offset;
|
|
|
|
#[macro_use]
|
|
extern crate serde_derive;
|
|
|
|
#[macro_use]
|
|
mod macros;
|
|
#[doc(hidden)]
|
|
pub mod backend;
|
|
mod backing;
|
|
|
|
pub mod cache;
|
|
pub mod error;
|
|
pub mod export;
|
|
pub mod global;
|
|
pub mod import;
|
|
pub mod instance;
|
|
pub mod memory;
|
|
pub mod module;
|
|
mod sig_registry;
|
|
pub mod structures;
|
|
mod sys;
|
|
pub mod table;
|
|
mod typed_func;
|
|
pub mod types;
|
|
pub mod units;
|
|
pub mod vm;
|
|
#[doc(hidden)]
|
|
pub mod vmcalls;
|
|
|
|
use self::error::CompileResult;
|
|
#[doc(inline)]
|
|
pub use self::error::Result;
|
|
#[doc(inline)]
|
|
pub use self::import::IsExport;
|
|
#[doc(inline)]
|
|
pub use self::instance::Instance;
|
|
#[doc(inline)]
|
|
pub use self::module::Module;
|
|
#[doc(inline)]
|
|
pub use self::typed_func::Func;
|
|
use std::sync::Arc;
|
|
|
|
use self::cache::{Artifact, Error as CacheError};
|
|
|
|
pub mod prelude {
|
|
pub use crate::import::{ImportObject, Namespace};
|
|
pub use crate::types::{
|
|
FuncIndex, GlobalIndex, ImportedFuncIndex, ImportedGlobalIndex, ImportedMemoryIndex,
|
|
ImportedTableIndex, LocalFuncIndex, LocalGlobalIndex, LocalMemoryIndex, LocalTableIndex,
|
|
MemoryIndex, TableIndex, Type, Value,
|
|
};
|
|
pub use crate::vm;
|
|
pub use crate::{func, imports};
|
|
}
|
|
|
|
/// Compile a [`Module`] using the provided compiler from
|
|
/// WebAssembly binary code. This function is useful if it
|
|
/// is necessary to a compile a module before it can be instantiated
|
|
/// and must be used if you wish to use a different backend from the default.
|
|
///
|
|
/// [`Module`]: struct.Module.html
|
|
pub fn compile_with(
|
|
wasm: &[u8],
|
|
compiler: &dyn backend::Compiler,
|
|
) -> CompileResult<module::Module> {
|
|
let token = backend::Token::generate();
|
|
compiler
|
|
.compile(wasm, Default::default(), token)
|
|
.map(|mut inner| {
|
|
let inner_info: &mut crate::module::ModuleInfo = &mut inner.info;
|
|
inner_info.import_custom_sections(wasm).unwrap();
|
|
module::Module::new(Arc::new(inner))
|
|
})
|
|
}
|
|
|
|
/// The same as `compile_with` but changes the compiler behavior
|
|
/// with the values in the `CompilerConfig`
|
|
pub fn compile_with_config(
|
|
wasm: &[u8],
|
|
compiler: &dyn backend::Compiler,
|
|
compiler_config: backend::CompilerConfig,
|
|
) -> CompileResult<module::Module> {
|
|
let token = backend::Token::generate();
|
|
compiler
|
|
.compile(wasm, compiler_config, token)
|
|
.map(|inner| module::Module::new(Arc::new(inner)))
|
|
}
|
|
|
|
/// Perform validation as defined by the
|
|
/// WebAssembly specification. Returns `true` if validation
|
|
/// succeeded, `false` if validation failed.
|
|
pub fn validate(wasm: &[u8]) -> bool {
|
|
use wasmparser::WasmDecoder;
|
|
let mut parser = wasmparser::ValidatingParser::new(wasm, None);
|
|
loop {
|
|
let state = parser.read();
|
|
match *state {
|
|
wasmparser::ParserState::EndWasm => break true,
|
|
wasmparser::ParserState::Error(_) => break false,
|
|
_ => {}
|
|
}
|
|
}
|
|
}
|
|
|
|
pub unsafe fn load_cache_with(
|
|
cache: Artifact,
|
|
compiler: &dyn backend::Compiler,
|
|
) -> std::result::Result<module::Module, CacheError> {
|
|
let token = backend::Token::generate();
|
|
compiler
|
|
.from_cache(cache, token)
|
|
.map(|inner| module::Module::new(Arc::new(inner)))
|
|
}
|
|
|
|
/// The current version of this crate
|
|
pub const VERSION: &str = env!("CARGO_PKG_VERSION");
|