#wasm-binary #wasm-interpreter #binary-format #binary-parser #wain

wain-syntax-binary

WebAssembly binary format parser for wain project

6 releases

0.1.5 Nov 18, 2023
0.1.4 Jun 13, 2020
0.1.2 May 24, 2020
0.1.1 Mar 29, 2020

#1170 in WebAssembly


Used in wain

MIT license

78KB
2K SLoC

wain-syntax-binary

crates.io CI

wain-syntax-binary is a crate to parse WebAssembly binary format files.

This crate is part of larger wain project.

Installation

[dependencies]
wain-syntax-binary = "0"

Usage

Using wain_syntax_binary::parse() is the easiest way.

extern crate wain_syntax_binary;

use std::fs;
use wain_syntax_binary::parse;

let source = fs::read("foo.wasm").unwrap();

match parse(&source) {
    Ok(tree) => { /* `tree` is `wain_ast::Root` value */ }
    Err(err) => eprintln!("Error! {}", err),
}

For the syntax tree structure parsed by this library, please see wain-ast crate.

Using Parser struct, it can parse part of Wasm binary.

extern crate wain_syntax_binary;

use std::fs;
use wain_syntax_binary::Parser;
use wain_ast::DataSegment;

let source = fs::read("data_segment_only.bin").unwrap();

// Parse only data segment
let data: DataSegment<'_> = Parser.parse().unwrap();

Working examples can be seen at examples/api/ directory

Please read documentation (not yet) for details.

License

the MIT license

Dependencies