lspkit-treesitter 0.0.1

LanguageParser trait + content-hash-keyed parse cache. Bundles no grammars.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

//! `LanguageParser` trait.
//!
//! A `LanguageParser` knows how to obtain a [`tree_sitter::Language`] and to
//! map a file extension to that language. Concrete grammars are supplied by
//! the consumer; this crate bundles none.

use tree_sitter::Language;

/// A language-specific parser plug-in.
pub trait LanguageParser: Send + Sync + 'static {
    /// Short identifier (e.g. `"rust"`, `"python"`).
    fn name(&self) -> &str;

    /// File extensions (lower-case, without the leading dot) handled by this parser.
    fn extensions(&self) -> &[&str];

    /// The tree-sitter language definition.
    fn language(&self) -> Language;
}

/// Errors emitted by parser registry lookups.
#[non_exhaustive]
#[derive(Debug, thiserror::Error)]
pub enum ParserError {
    /// No parser registered for the given extension.
    #[error("no parser registered for extension: {0}")]
    UnknownExtension(String),
}