Crate tree_sitter_symbols_rust 

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

tss-rust provides type-safe Rust enums for every node type in the tree-sitter-rust grammar. This eliminates error-prone string comparisons like node.kind() == "function_item" in favor of NodeType::FunctionItem, enabling compile-time verification and better IDE support.

Quick Start

[dependencies]
tss-rust = "0.2"
tree-sitter = "0.24"
tree-sitter-rust = "0.24"

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

By default, this crate has no features enabled. You must explicitly enable the node types and metadata you need. This keeps compile times fast and binary sizes small.

The crate uses Cargo features to control which node types and metadata are available:

Node Type Features

Each tree-sitter node type corresponds to a feature. Enable specific nodes:

tss-rust = { version = "0.2", features = ["function_item", "struct_item"] }

Or enable all node types at once:

tss-rust = { version = "0.2", features = ["node_full"] }

The node feature is a tracking feature automatically enabled when any node type is active. You don’t need to enable it manually - it’s used internally for conditional compilation.

Metadata Features

Control which metadata from tree-sitter’s NODE_TYPES JSON is included:

• 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

Enable all metadata:

tss-rust = { version = "0.2", features = ["meta_full"] }

Or select specific metadata categories:

tss-rust = { version = "0.2", features = ["meta_named", "meta_fields"] }

The meta feature is a tracking feature automatically enabled when any metadata feature is active. You don’t need to enable it manually - it’s used internally for conditional compilation.

Complete Feature Matrix

# Default: empty - no features enabled
tss-rust = "0.2"

# Everything: all nodes + all metadata
tss-rust = { version = "0.2", features = ["full"] }

# Just nodes, no metadata
tss-rust = { version = "0.2", features = ["node_full"] }

# Just metadata, no nodes
tss-rust = { version = "0.2", features = ["meta_full"] }

# Specific nodes with selected metadata
tss-rust = { version = "0.2", features = [
    "function_item",
    "struct_item",
    "meta_named"
]}

How It Works

At build time, tss-rust reads the NODE_TYPES constant from the tree-sitter-rust crate and generates:

• A NodeType enum with variants for all 280+ node types
• FromStr implementation for parsing node type strings
• Display implementation for converting back to strings
• Documentation linking to Rust language reference where applicable
• Feature-gated compilation so you only pay for what you use

All generation happens at compile time with zero runtime dependencies. The generated code is feature-gated, so with no features enabled, the crate compiles to almost nothing.

Design Philosophy

Type Safety: String comparisons are error-prone and not checked at compile time. Using enum variants catches typos early and enables exhaustive pattern matching.

Minimal Overhead: With no default features, you explicitly choose what to include. Add only the node types you actually use in your tree-sitter traversals.

Build-Time Generation: By generating at build time rather than using macros, we get better IDE support, faster compile times, and the ability to inspect generated code.

Enums

NodeType

Tree-sitter node types for Rust