From 2aa4a82499d4becd2284cdb482213d541b8804dd Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 28 Apr 2024 16:29:10 +0200 Subject: Adding upstream version 86.0.1. Signed-off-by: Daniel Baumann --- third_party/rust/wast/README.md | 62 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 third_party/rust/wast/README.md (limited to 'third_party/rust/wast/README.md') diff --git a/third_party/rust/wast/README.md b/third_party/rust/wast/README.md new file mode 100644 index 0000000000..548a3630e8 --- /dev/null +++ b/third_party/rust/wast/README.md @@ -0,0 +1,62 @@ +
+

wast

+ +A Bytecode Alliance project + +

+ A Rust parser for the WebAssembly Text Format (WAT). +

+ +

+ Crates.io version + Download + docs.rs docs +

+
+ + +## Usage + +Add this to your `Cargo.toml`: + +```toml +[dependencies] +wast = "22.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. + +```toml +[dependencies] +wast = { version = "22.0", default-features = false } +``` + +# License + +This project is licensed under the Apache 2.0 license with the LLVM exception. +See [LICENSE](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. -- cgit v1.2.3