module Noir::TreeSitter

Overview

Thin high-level facade. Keeps tree lifetime tied to an object so callers don't have to think about ts_tree_delete.

Defined in:

ext/tree_sitter/tree_sitter.cr

Constant Summary

MAX_AST_DEPTH = 1024

Recursion guard for AST walkers. Crystal's default fiber stack is generous (~8 MB) but a malicious source file with deeply nested syntax — (((((((...))))))) chains, deeply nested object literals, recursive template expressions — could cascade through a custom walker until the stack runs out. Real production code rarely nests beyond ~100 levels, so 1024 is comfortably above legitimate input and well below the stack ceiling.

Class Method Summary

• .each_named_child(node : LibTreeSitter::TSNode, &)

  Iterates named children without allocating an array.

• .field(node : LibTreeSitter::TSNode, name : String) : LibTreeSitter::TSNode | Nil
• .node_start_row(node : LibTreeSitter::TSNode) : Int32
• .node_text(node : LibTreeSitter::TSNode, source : String) : String
• .node_type(node : LibTreeSitter::TSNode) : String
• .parse(source : String, language : LibTreeSitter::TSLanguage, &)

  Parses source with the given language and yields the root LibTreeSitter::TSNode.

• .parse_go(source : String, &)

  Parses source with the Go grammar and yields the root node.

• .parse_java(source : String, &)

  Parses source with the Java grammar and yields the root node.

• .parse_javascript(source : String, &)

  Parses source with the JavaScript grammar and yields the root node.

• .parse_kotlin(source : String, &)

  Parses source with the Kotlin grammar and yields the root node.

• .parse_python(source : String, &)

  Parses source with the Python grammar and yields the root node.

• .parse_rust(source : String, &)

  Parses source with the Rust grammar and yields the root node.

• .parser_pool_size(language : LibTreeSitter::TSLanguage) : Int32

  Idle parser count for a given language.

• .python_sexp(source : String) : String

  Convenience: returns the root-node s-expression for source.

Class Method Detail