Show the crate…
3 releases (breaking)
0.42.1 | Feb 11, 2021 |
---|---|
0.41.0 | Mar 4, 2021 |
0.31.1 | Feb 21, 2021 |
#30 in #wasm-bytecode
927 downloads per month
Used in 182 crates
(11 directly)
305KB
8K
SLoC
tetsy-wasm
Low-level WebAssembly format library.
Rust WebAssembly format serializing/deserializing
Add to Cargo.toml
[dependencies]
tetsy-wasm = "0.42"
and then
let module = tetsy_wasm::deserialize_file("./res/cases/v1/hello.wasm").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 wasm file: {}", code_section.bodies().len());
Wabt Test suite
tetsy-wasm
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 tetsy-wasm builds it internally usingwabt-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 wasm-opt
(https://github.com/WebAssembly/binaryen):
- make sure you have all prerequisites to build
binaryen
andcargo-fuzz
(cmake
and a C++11 toolchain) - checkout with submodules (
git submodule update --init --recursive
) - install
cargo fuzz
subcommand withcargo 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
(still requires allocator though):
[dependencies]
tetsy-wasm = { version = "0.41", default-features = false }
License
tetsy-wasm
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
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in tetsy-wasm by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.