#lsp-language-server #language-server #dap #lsp

sync-ls

Synchronized language service inspired by async-lsp, primarily for tinymist

3 releases

0.13.10 Mar 23, 2025
0.13.10-rc2 Mar 21, 2025
0.13.10-rc1 Mar 19, 2025

#177 in Development tools

Download history 339/week @ 2025-03-19

339 downloads per month

Apache-2.0

86KB
2K SLoC

sync-ls

Sync LSP server inspired by async-lsp, primarily for tinymist. The author of this crate thinks that async-lsp is better than sync-ls, so please use async-lsp whenever possible unless you have a good reason to use sync-ls. Some random points:

  • The req_queue and transport are extracted from the rust-analyzer project.
  • The sync-ls should have better performance on stdio transport than async-lsp, especially on windows, but the author have forgotten the idea.
  • The sync-ls handlers can get a mutable reference to the state, which is not possible in tower-lsp.
  • The sync-ls supports both LSP and DAP with a common codebase.

Debugging with input mirroring

You can record the input during running the editors with binary. You can then replay the input to debug the language server.

# Record the input
your-ls --mirror input.txt
# Replay the input
your-ls --replay input.txt

This is much more useful when devloping a dap server.

Usage

Starts a LSP server with stdio transport:

with_stdio_transport::<LspMessage>(args.mirror.clone(), |conn| {
    let client = LspClientRoot::new(tokio_handle, conn.sender);
    LspBuilder::new(args, client.weak())
        // Adds request handlers
        .with_request::<Shutdown>(State::shutdown)
        // Adds event handlers
        .with_event(&LspInterrupt::Settle, State::interrupt)
        .build()
        .start(conn.receiver, is_replay)
})?;

Dependencies

~4–12MB
~134K SLoC