Crates.io | xwasm |
lib.rs | xwasm |
version | 0.31.3 |
source | src |
created_at | 2019-05-14 13:49:52.763884 |
updated_at | 2019-05-14 13:49:52.763884 |
description | WebAssembly binary format serialization/deserialization/interpreter |
homepage | https://github.com/susytech/xwasm |
repository | https://github.com/susytech/xwasm |
max_upload_size | |
id | 134278 |
size | 254,211 |
Low-level WebAssembly format library.
Add to Cargo.toml
[dependencies]
xwasm = "0.31"
and then
extern crate xwasm;
let module = xwasm::deserialize_file("./res/cases/v1/hello.xwasm").unwrap();
assert!(module.code_section().is_some());
let code_section = module.code_section().unwrap(); // Part of the module with functions code
println!("Function count in xwasm file: {}", code_section.bodies().len());
xwasm
supports full wabt testsuite (https://github.com/WebAssembly/testsuite), running asserts that involves deserialization.
To run testsuite:
wabt
(since xwasm builds it internally using wabt-rs
, see https://github.com/WebAssembly/wabt)git submodule update --init --recursive
)cargo test --release --manifest-path=spec/Cargo.toml
Decoder can be fuzzed with cargo-fuzz
using xwasm-opt
(https://github.com/WebAssembly/binaryen):
binaryen
and cargo-fuzz
(cmake
and a C++11 toolchain)git submodule update --init --recursive
)cargo fuzz
subcommand with cargo install cargo-fuzz
cargo fuzz
uses a rust compiler plugin: rustup override set nightly
cargo fuzz run deserialize
no_std
cratesThis crate has a feature, std
, that is enabled by default. To use this crate
in a no_std
context, add the following to your Cargo.toml
:
[dependencies]
xwasm = { version = "0.31", default-features = false }
Until allocator api is stabilized, this type of use is limited to nightly Rust.
xwasm
is primarily distributed under the terms of both the MIT
license and the Apache License (Version 2.0), at your choice.
See LICENSE-APACHE, and LICENSE-MIT for details.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in xwasm by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.