Struct difft::parse::tree_sitter_parser::TreeSitterConfig

pub(crate) struct TreeSitterConfig {
    pub(crate) language: Language,
    atom_nodes: HashSet<&'static str>,
    delimiter_tokens: Vec<(&'static str, &'static str)>,
    highlight_query: Query,
    sub_languages: Vec<TreeSitterSubLanguage>,
}

Configuration for a tree-sitter parser.

Fields

language: Language

The tree-sitter language parser.

atom_nodes: HashSet<&'static str>

Tree-sitter nodes that we treat as indivisible atoms.

This is particularly useful for strings, as some grammars use several nodes for a single string literal. We don’t want to say e.g. the closing string delimiter moved, as it’s confusing and not well-balanced syntax.

This is also useful for when tree-sitter nodes don’t include all the children in the source. This is known limitation of tree-sitter, and occurs more often for complex string syntax. https://github.com/tree-sitter/tree-sitter/issues/1156

delimiter_tokens: Vec<(&'static str, &'static str)>

We want to consider delimiter tokens as part of lists, not standalone atoms. Tree-sitter includes delimiter tokens, so mark which token pairs we consider to be delimiters.

highlight_query: Query

Tree-sitter query used for syntax highlighting this language.

sub_languages: Vec<TreeSitterSubLanguage>

Sub-languages in use, if any.