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

Cargo Features

• lsp_server: Enables the LSP server (uses lsp_server).

Inspirations / Similar Projects

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

License

Licensed under either of

• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.