xwasm

Low-level WebAssembly format library.

Documentation

Rust WebAssembly format serializing/deserializing

Add to Cargo.toml

toml [dependencies] xwasm = "0.31"

and then

```rust

extern crate xwasm;

let module = xwasm::deserializefile("./res/cases/v1/hello.xwasm").unwrap(); assert!(module.codesection().is_some());

let codesection = module.codesection().unwrap(); // Part of the module with functions code

println!("Function count in xwasm file: {}", code_section.bodies().len()); ```

Wabt Test suite

xwasm supports full wabt testsuite (https://github.com/WebAssembly/testsuite), running asserts that involves deserialization.

To run testsuite: - make sure you have all prerequisites to build wabt (since xwasm builds it internally using wabt-rs, see https://github.com/WebAssembly/wabt) - checkout with submodules (git submodule update --init --recursive) - run cargo test --release --manifest-path=spec/Cargo.toml

Decoder can be fuzzed with cargo-fuzz using xwasm-opt (https://github.com/WebAssembly/binaryen):

make sure you have all prerequisites to build binaryen and cargo-fuzz (cmake and a C++11 toolchain)
checkout with submodules (git submodule update --init --recursive)
install cargo fuzz subcommand with cargo install cargo-fuzz
set rustup to use a nightly toolchain, because cargo fuzz uses a rust compiler plugin: rustup override set nightly
run cargo fuzz run deserialize

`no_std` crates

This 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:

toml [dependencies] xwasm = { version = "0.31", default-features = false }

Until allocator api is stabilized, this type of use is limited to nightly Rust.

License

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.

Contribution