A Rust-native WebAssembly syntax model useful for generating, parsing, and emitting WebAssembly code.
WASM-AST is designed with minimal validation. The goal is to closely model the WASM syntax specification in order to allow valid and invalid abstract syntax trees. Lastly, modules cannot be mutated once built.
A parser for binary WebAssembly format. Attempts to maintain as much of the binary information as possible.
A parser for the text and binary WebAssembly formats. The text format is transformed to binary, then passed to the binary parser. Some information may be lost in the text to binary conversion.
Emits binary WebAssembly format for a module.
To use wasm-ast, first add this to your Cargo.toml:
[dependencies]
wasm-ast = "0.1.0"Then, add this to your crate:
use wasm_ast::model::Module;
fn main() {
let mut builder = Module::builder();
let module = builder.build();
}Create an empty WASM module:
use wasm_ast::model::Module;
fn main() {
let module = Module::empty();
}Additional (i.e., more useful) examples can be found in the repository.
The interface is considered stable. No breaking changes will be introduced until the next major version (e.g. 1.0).
Please file any issues for areas where this crate does not properly adhere to the WebAssembly standard.
Licensed under Apache License, Version 2.0 (LICENSE-APACHE or http://apache.org/licenses/LICENSE-2.0)
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.