2 unstable releases

0.2.0 Jan 5, 2025
0.1.0 Nov 30, 2024

#2249 in Parser implementations

Download history 125/week @ 2024-11-27 43/week @ 2024-12-04 16/week @ 2024-12-11 1/week @ 2024-12-18 140/week @ 2025-01-01 25/week @ 2025-01-08

166 downloads per month
Used in 3 crates (2 directly)

MIT license

155KB
5K SLoC

The parser for WebAssembly Text Format.

This parser is error-tolerant, which means it can parse even even if the input contains syntax errors.

This parser will produce concrete syntax tree (CST), but you can build AST from it with a bunch of helpers from wat_syntax::ast module.

Usage

You need to create a parser instance with source code. Once created, the source code can't be changed. So if you want to parse different source code, you need to create a new parser instance.

use wat_parser::Parser;
use wat_syntax::SyntaxKind;

let input = "(module)";
let mut parser = Parser::new(input);
let tree = parser.parse();
assert_eq!(tree.kind(), SyntaxKind::ROOT);

Any syntax errors won't prevent the parser from parsing the rest of the input, however you can retrieve the errors like this:

use wat_parser::Parser;
use wat_syntax::SyntaxKind;

let input = "(module";
let mut parser = Parser::new(input);
let tree = parser.parse();
let errors = parser.errors();
assert_eq!(errors[0].start, 7);
assert!(errors[0].message.to_string().contains("expected `)`"));

Dependencies

~1.5MB
~30K SLoC