#parser #web-assembly #wasm

wasmparser-nostd

A simple event-driven library for parsing WebAssembly binary files

7 releases (breaking)

0.100.1 Feb 11, 2023
0.100.0 Feb 11, 2023
0.99.0 Feb 1, 2023
0.91.0 Sep 21, 2022
0.82.0 Jan 22, 2022

#210 in WebAssembly

Download history 4630/week @ 2022-12-07 4072/week @ 2022-12-14 3539/week @ 2022-12-21 2566/week @ 2022-12-28 4273/week @ 2023-01-04 4701/week @ 2023-01-11 5340/week @ 2023-01-18 6085/week @ 2023-01-25 6289/week @ 2023-02-01 8314/week @ 2023-02-08 7559/week @ 2023-02-15 8024/week @ 2023-02-22 7012/week @ 2023-03-01 8799/week @ 2023-03-08 12444/week @ 2023-03-15 8910/week @ 2023-03-22

38,744 downloads per month
Used in 9 crates (2 directly)

Apache-2.0 WITH LLVM-exception

665KB
14K SLoC

This is a fork of the wasmparser crate by the Bytecode Alliance with the sole purpose to add no_std support with a focus on embedded environments.

This crate will be deprecated as soon as the original wasmparser crate itself supports no_std.

Note: As of version 0.99.0 and above the Url type from the url crate was replaced with a simple String in order to port the entire crate to no_std. This is because the complex url crate itself does not support no_std compilation.

The WebAssembly binary file decoder in Rust

A Bytecode Alliance project

crates.io link docs.rs docs

The decoder library provides lightweight and fast decoding/parsing of WebAssembly binary files.

The other goal is minimal memory footprint. For this reason, there is no AST or IR of WebAssembly data.

See also its sibling at https://github.com/wasdk/wasmparser

Documentation

The documentation and examples can be found at the https://docs.rs/wasmparser/

Fuzzing

To fuzz test wasmparser.rs, switch to a nightly Rust compiler and install cargo-fuzz:

cargo install cargo-fuzz

Then, from the root of the repository, run:

cargo fuzz run parse

If you want to use files as seeds for the fuzzer, add them to fuzz/corpus/parse/ and restart cargo-fuzz.

Dependencies