54aee7836c
Differential Revision: https://phabricator.services.mozilla.com/D80190 |
||
---|---|---|
.. | ||
src | ||
tests | ||
.cargo-checksum.json | ||
Cargo.toml | ||
LICENSE-APACHE | ||
LICENSE-MIT | ||
README.md |
README.md
Usage
Add this to your Cargo.toml
:
[dependencies]
wast = "17.0"
The intent of this crate is to provide utilities, combinators, and built-in types to parse anything that looks like a WebAssembly s-expression.
- Need to parse a
*.wat
file? - Need to parse a
*.wast
file? - Need to run test suite assertions from the official wasm test suite?
- Want to write an extension do the WebAssembly text format?
If you'd like to do any of the above this crate might be right for you! You may
also want to check out the wat
crate which provides a much more stable
interface if all you'd like to do is convert *.wat
to *.wasm
.
Cargo features
By default this crate enables and exports support necessary to parse *.wat
and
*.wast
files, or in other words entire wasm modules. If you're using this
crate, however, to parse simply an s-expression wasm-related format (like
*.witx
or *.wit
perhaps) then you can disable the default set of features to
only include a lexer, the parsing framework, and a few basic token-related
parsers.
[dependencies]
wast = { version = "17.0", default-features = false }
License
This project is licensed under the Apache 2.0 license with the LLVM exception. See LICENSE for more details.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.