# tree-sitter/tree-sitter-rust architecture

> Architecture diagram of the GitHub repository tree-sitter/tree-sitter-rust, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tree-sitter/tree-sitter-rust
- Repository: https://github.com/tree-sitter/tree-sitter-rust

## Overview

##### Project type and purpose
- This is an open-source Tree-sitter grammar library for Rust (“tree-sitter-rust”) with first-class language bindings (C, Go, Node, Python, Rust, Swift) and query files for highlighting, injections, and tags.
- Purpose: define Rust’s grammar, generate a C parser/lexer library, and expose it to multiple host languages for incremental parsing in editors, linters, formatters, etc.

##### File structure
- Top-level build/config files: CMakeLists.txt, Makefile, binding.gyp, Cargo.toml, Package.json, setup.py, pyproject.toml, go.mod, Package.swift
- Core grammar & parser implementation in src/ and grammar.js, scanner.c, parser.c, node-types.json, grammar.json
- Language bindings under bindings/{c,go,node,python,rust,swift}
- Query files (highlighting, injections, tags) in queries/
- Examples in examples/, tests in test/ and bindings/*/tests
- CI/workflows in .github/workflows/

##### README for additional insights
- Confirms it’s a performance-focused grammar implementation

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Design-Time"
        Grammar["Grammar Definition"]:::core
        CodeGen["Code Generator / Tree-sitter CLI"]:::core
    end

    subgraph "Build-Time"
        Scanner["Scanner (C)"]:::core
        ParserCore["Parser Core (C Library)"]:::core
        BuildFiles["Build & Packaging"]:::build
        CI["CI Pipelines"]:::build
    end

    subgraph "Run-Time"
        QueryModules["Query Modules"]:::query
        QueryEngine["Query Engine"]:::core
        subgraph "Language Bindings"
            C_Bind["C Binding (Native API)"]:::binding
            Go_Bind["Go Binding (cgo)"]:::binding
            Node_Bind["Node.js Binding (N-API)"]:::binding
            Py_Bind["Python Binding (CPython Extension)"]:::binding
            Rust_Bind["Rust Binding (Cargo Library)"]:::binding
            Swift_Bind["Swift Binding (Swift Package)"]:::binding
        end
        Clients["Clients / Editors"]:::external
    end

    Grammar -->|".js, .json files"| CodeGen
    CodeGen -->|".c/.h code"| Scanner
    CodeGen -->|".c/.h code"| ParserCore
    Scanner -->|compiled| ParserCore
    ParserCore -->|native library| C_Bind
    ParserCore -->|native library| Go_Bind
    ParserCore -->|native library| Node_Bind
    ParserCore -->|native library| Py_Bind
    ParserCore -->|native library| Rust_Bind
    ParserCore -->|native library| Swift_Bind
    C_Bind -->|C API| Clients
    Go_Bind -->|Go API| Clients
    Node_Bind -->|JS API| Clients
    Py_Bind -->|Python API| Clients
    Rust_Bind -->|Rust API| Clients
    Swift_Bind -->|Swift API| Clients
    QueryModules -->|SCM queries| QueryEngine
    QueryEngine -->|matches AST| Clients
    CI -->|runs builds/tests| BuildFiles
    BuildFiles -->|invokes| CodeGen
    BuildFiles -->|invokes| Scanner
    BuildFiles -->|invokes| ParserCore
    BuildFiles -->|packages| C_Bind
    BuildFiles -->|packages| Go_Bind
    BuildFiles -->|packages| Node_Bind
    BuildFiles -->|packages| Py_Bind
    BuildFiles -->|packages| Rust_Bind
    BuildFiles -->|packages| Swift_Bind

    click Grammar "https://github.com/tree-sitter/tree-sitter-rust/blob/master/grammar.js"
    click Scanner "https://github.com/tree-sitter/tree-sitter-rust/blob/master/src/scanner.c"
    click ParserCore "https://github.com/tree-sitter/tree-sitter-rust/blob/master/src/parser.c"
    click CodeGen "https://github.com/tree-sitter/tree-sitter-rust/blob/master/binding.gyp"
    click C_Bind "https://github.com/tree-sitter/tree-sitter-rust/blob/master/bindings/c/tree-sitter-rust.h"
    click Go_Bind "https://github.com/tree-sitter/tree-sitter-rust/blob/master/bindings/go/binding.go"
    click Node_Bind "https://github.com/tree-sitter/tree-sitter-rust/blob/master/bindings/node/binding.cc"
    click Py_Bind "https://github.com/tree-sitter/tree-sitter-rust/blob/master/bindings/python/tree_sitter_rust/binding.c"
    click Rust_Bind "https://github.com/tree-sitter/tree-sitter-rust/blob/master/bindings/rust/lib.rs"
    click Swift_Bind "https://github.com/tree-sitter/tree-sitter-rust/blob/master/bindings/swift/TreeSitterRust/rust.h"
    click QueryModules "https://github.com/tree-sitter/tree-sitter-rust/blob/master/queries/highlights.scm"
    click BuildFiles "https://github.com/tree-sitter/tree-sitter-rust/blob/master/CMakeLists.txt"
    click CI "https://github.com/tree-sitter/tree-sitter-rust/blob/master/.github/workflows/ci.yml"

    classDef core fill:#ADD8E6,stroke:#0000FF,color:#000
    classDef binding fill:#90EE90,stroke:#008000,color:#000
    classDef build fill:#FFD700,stroke:#FFA500,color:#000
    classDef query fill:#DDA0DD,stroke:#800080,color:#000
    classDef external fill:#F0F0F0,stroke:#888888,color:#000
```
