auto_lsp is a generic library for creating Abstract Syntax Trees (AST) and Language Server Protocol (LSP) servers.

It leverages crates such as lsp_types, lsp_server, salsa, and texter, and generates the AST of a Tree-sitter language to simplify building LSP servers.

auto_lsp provides useful abstractions while remaining flexible. You can override the default database as well as all LSP request and notification handlers.

It is designed to be as language-agnostic as possible, allowing any Tree-sitter grammar to be used.

See ARCHITECTURE.md for more information.

✨ Features

• Generates a thread-safe, immutable and iterable AST with parent-child relations from a Tree-sitter language.
• Supports downcasting of AST nodes to concrete types.
• Integrates with a Salsa database and parallelize LSP requests and notifications.

📚 Documentation

• Book
• docs.rs

Examples

• HTML AST
• Python AST
• Simple LSP server
• VSCode extension
• VSCode extension with WASI

Cargo Features

• lsp_server: Enables the LSP server (uses lsp_server).
• wasm: Enables WASM support (compatible only with wasi-p1-threads).

Inspirations / Similar Projects

• Volar
• Type-sitter
• Rust Analyzer
• Ruff
• texter by airblast-dev, which saved hours of headaches.