1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
# The WebAssembly binary file decoder in Rust
**A [Bytecode Alliance](https://bytecodealliance.org/) project**
[](https://travis-ci.org/yurydelendik/wasmparser.rs)
[](https://crates.io/crates/wasmparser)
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/
## Example
```rust
use wasmparser::WasmDecoder;
use wasmparser::Parser;
use wasmparser::ParserState;
fn get_name(bytes: &[u8]) -> &str {
str::from_utf8(bytes).ok().unwrap()
}
fn main() {
let ref buf: Vec<u8> = read_wasm_bytes();
let mut parser = Parser::new(buf);
loop {
let state = parser.read();
match *state {
ParserState::BeginWasm { .. } => {
println!("====== Module");
}
ParserState::ExportSectionEntry { field, ref kind, .. } => {
println!(" Export {} {:?}", get_name(field), kind);
}
ParserState::ImportSectionEntry { module, field, .. } => {
println!(" Import {}::{}", get_name(module), get_name(field))
}
ParserState::EndWasm => break,
_ => ( /* println!(" Other {:?}", state) */ )
}
}
}
```
## 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.
[cargo-fuzz]: https://github.com/rust-fuzz/cargo-fuzz
|
