treesitter-types

Generate fully-typed Rust structs and enums from any tree-sitter grammar's node-types.json.

Instead of stringly-typed access like node.kind() == "function_declaration", get compile-time checked types with proper field access, Option<T> for optional fields, Vec<T> for repeated fields, and enums for alternations.

Usage

Via build.rs (recommended)

Add to your Cargo.toml:

[dependencies]
treesitter-types = "0.1"

[build-dependencies]
treesitter-types = "0.1"

Create a build.rs:

fn main() {
    treesitter_types::codegen::emit_to_out_dir("path/to/node-types.json").unwrap();
}

Include the generated code in lib.rs:

include!(concat!(env!("OUT_DIR"), "/treesitter_types_generated.rs"));

Via proc-macro

[dependencies]
treesitter-types = "0.1"
treesitter-types-macros = "0.1"

treesitter_types_macros::generate_types!("path/to/node-types.json");

Example

Given tree-sitter-go's node-types.json, the generated types let you write:

use treesitter_types_go::*;

let mut parser = tree_sitter::Parser::new();
parser.set_language(&tree_sitter_go::LANGUAGE.into()).unwrap();
let tree = parser.parse(src, None).unwrap();
let source_file = SourceFile::from_node(tree.root_node(), src).unwrap();

for child in &source_file.children {
    match child {
        SourceFileChildren::FunctionDeclaration(func) => {
            println!("fn {}", func.name.text());
        }
        SourceFileChildren::PackageClause(pkg) => {
            println!("package {}", pkg.children.text());
        }
        _ => {}
    }
}

What gets generated

Runtime traits

Every generated type implements:

• FromNode<'tree> - construct from a tree_sitter::Node
• Spanned - access source location (span(), start(), end())
• LeafNode<'tree> (terminal nodes only) - access source text via text()

Pre-generated language crates

Ready-to-use typed AST crates for 25 languages — no codegen step needed:

[dependencies]
treesitter-types-python = "0.1"

Each language crate re-exports tree_sitter and its grammar crate (e.g. tree_sitter_python), so no extra dependencies are needed.

Tested against

The codegen is validated against real-world repositories with zero failures on cleanly-parsed files:

Run the integration tests yourself:

just integration-test-go
just integration-test-python
just integration-test-all    # run all languages

License

Licensed under either of Apache License, Version 2.0 or MIT License at your option.