compactp_parser 0.1.0-beta.1

Recursive-descent parser for the Compact language producing a lossless CST and structured diagnostics.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

# compactp_parser

Recursive-descent parser for the Compact language (Midnight Network), the core of
the [`compactp`](https://github.com/devrelaicom/compactp) parser frontend.

Produces a lossless concrete syntax tree (every byte recoverable) plus a list of
structured diagnostics. Uses marker-based tree construction over
[`rowan`](https://crates.io/crates/rowan), Pratt-style expression precedence, and
explicit error recovery with `ERROR` nodes. Bounded recursion depth
(`ParseOptions::max_depth`, default 256) guarantees no stack overflow on
adversarial input.

## Example

```rust
use compactp_parser::parse;
use compactp_syntax::{SyntaxKind, SyntaxNode};

let result = parse("");
let root = SyntaxNode::new_root(result.green);
assert_eq!(root.kind(), SyntaxKind::SOURCE_FILE);
assert!(result.errors.is_empty());
```

## Status

Beta (`0.x`). APIs may change between minor versions. See the
[compatibility matrix](https://github.com/devrelaicom/compactp#compact-compatibility).

## License

MIT