tss-rust 0.2.2

Generated node type enums and metadata from tree-sitter-rust
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

# tss-rust

[![crates.io](https://img.shields.io/crates/v/tss-rust.svg)](https://crates.io/crates/tss-rust)
[![documentation](https://docs.rs/tss-rust/badge.svg)](https://docs.rs/tss-rust)
[![MIT licensed](https://img.shields.io/crates/l/tss-rust.svg)](../../LICENSE)

Generated node type enums and metadata from tree-sitter-rust.

## Usage

```toml
[dependencies]
tss-rust = "0.1"
tree-sitter = "0.24"
tree-sitter-rust = "0.24"
```

```rust
use tree_sitter_symbols_rust::NodeType;
use std::str::FromStr;

let node_type = NodeType::from_str("function_item")?;
assert_eq!(node_type, NodeType::FunctionItem);
assert_eq!(node_type.to_string(), "function_item");
```

## Features

Default includes all metadata:
```toml
tss-rust = "0.1"
```

Select specific metadata:
```toml
tss-rust = { version = "0.1", default-features = false, features = ["meta_named", "meta_fields"] }
```

Available metadata features:
- `meta_named` - whether nodes are named in the grammar
- `meta_subtypes` - possible subtypes for each node
- `meta_fields` - named fields nodes can have
- `meta_children` - anonymous children nodes can have
- `meta_extra` - extra node markers
- `meta_root` - root node markers

## How It Works

At build time, each language reads the corresponding `tree-sitter-*` language crate's `NODE_TYPES` constant and generates:

- A `NodeType` enum with all 280 node types
- `FromStr` for parsing node type strings
- `Display` for converting back to strings
- Documentation linking to language reference (best effort, not comprehensive)

This allows a crate to ship this information as an enum type with zero runtime dependencies. All generation happens at compile time.
This is useful for type safety (rather than checking for strings, as well as hopefully to demystify how tree-sitter languages work.


## Licensing

MIT licensed - see [LICENSE](https://github.com/lmmx/tss/blob/master/LICENSE) for details.