daml-syntax 0.4.0

Shared parsed-source surface for Daml tools
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

# daml-syntax

`daml-syntax` is the shared parsed-source surface for Daml tools in this
workspace. It owns source presentation around `daml-parser`: diagnostics, line
mapping, UTF-16 offsets, token/trivia access, and parser span conversion.

```rust
let source = "module M where\nfoo : Int\nfoo = 1\n";
let file = daml_syntax::SourceFile::parse(source);

assert!(file.diagnostics().is_empty());
assert_eq!(file.module().name, "M");
assert_eq!(file.line_index().line_col(0.into()).line, 1);
```

For callers that only need lexer, trivia, or laid-out token facts, use the
lighter tokenized surface:

```rust
let tokens = daml_syntax::SourceTokens::lex(source);

assert!(tokens.lex_errors().is_empty());
assert!(!tokens.laid_out_tokens().is_empty());
```