# tree-sitter-uxntal

This crate provides a Uxn Tal Assembly grammar for the [tree-sitter][] parsing library. To
use this crate, add it to the `[dependencies]` section of your `Cargo.toml`
file. (Note that you will probably also need to depend on the
[`tree-sitter`][tree-sitter crate] crate to use the parsed result in any useful
way.)

```toml
[dependencies]
tree-sitter = "~0.20.9"
tree-sitter-uxntal = "1.0.0"
```

Typically, you will use the [language][language func] function to add this
grammar to a tree-sitter [Parser][], and then use the parser to parse some code:

```rust
let code = r#"
|0100 ( init )

    ;hello-word ;print-text JSR2

BRK

@print-text ( str* -- )

    &while
        ( send ) LDAk #18 DEO
        ( loop ) INC2 LDAk ,&while JCN
    POP2

JMP2r
"#;
let mut parser = Parser::new();
parser.set_language(tree_sitter_uxntal::language()).expect("Error loading Uxntal grammar");
let parsed = parser.parse(code, None);
```

If you have any questions, please reach out to us in the [tree-sitter
discussions] page.

[language func]: https://docs.rs/tree-sitter-uxntal/*/tree_sitter_uxntal/fn.language.html
[parser]: https://docs.rs/tree-sitter/*/tree_sitter/struct.Parser.html
[tree-sitter]: https://tree-sitter.github.io/
[tree-sitter crate]: https://crates.io/crates/tree-sitter
[tree-sitter discussions]: https://github.com/tree-sitter/tree-sitter/discussions