bacon-ls

Crates.iobacon-ls
lib.rsbacon-ls
version0.3.0
sourcesrc
created_at2024-05-17 22:49:59.955751
updated_at2024-05-21 11:19:56.516425
descriptionBacon Language Server
homepagehttps://github.com/crisidev/bacon-ls
repositoryhttps://github.com/crisidev/bacon-ls
max_upload_size
id1243779
size3,464,434
Matteo Bigoi (crisidev)

documentation

https://github.com/crisidev/bacon-ls

README

🐽 Bacon Language Server 🐽

Ci Release Crates.io License

LSP Server wrapper for the exceptional Bacon exposing textDocument/diagnostic and workspace/diagnostic capabilities.

See bacon-ls 🐽 blog post: https://lmno.lol/crisidev/bacon-language-server

Bacon screenshot

bacon-ls 🐽 is meant to be easy to include in your IDE configuration.

Features - ✅ done 🕖 in progress 🌍 future

Bacon gif

Installation

First, install Bacon and bacon-ls 🐽

❯❯❯ cargo install --locked bacon bacon-ls

Configure Bacon export-locations settings with bacon-ls 🐽 export format:

[export]
enabled = true
path = ".bacon-locations"
line_format = "{kind}:{path}:{line}:{column}:{message}"

Configuration

The language server can be configured using the appropriate LSP protocol and supports the following values:

  • locationsFile Bacon export filename, default .bacon-locations.
  • waitTimeSeconds Maximum time in seconds the LSP server waits for Bacon to update the export file before loading the new diagnostics, default 10.

Neovim - LazyVim

return {
    {
        "neovim/nvim-lspconfig",
        opts = {
            diagnostics = {
                update_in_insert = true,
            },
            servers = {
                rust_analyzer = { enable = false },
                bacon_ls = {
                    enable = true
                    settings = {
                        -- locationsFile = ".locations",
                        -- waitTimeSeconds = 5
                    },
                },
            },
        },
    },
    {
        "mrcjkb/rustaceanvim",
        opts = {
            default_settings = {
                ["rust-analyzer"] = {
                    diagnostics = { enable = false },
                    checkOnSave = { enable = false },
                },
            },
        },
    },
}

Neovim - Manual

NeoVim requires nvim-lspconfig to be configured and rust-analyzer diagnostics must be turned off for Bacon-Ls 🐽 to properly function.

bacon-ls is part of nvim-lspconfig from commit 6d2ae9f and it can be configured like any other LSP server works best when vim.diagnostics.Opts.update_in_insert is set to true.

require("lspconfig.configs").bacon_ls.setup({
    autostart=true,
    settings = {
        -- locationsFile = ".locations",
        -- waitTimeSeconds = 5
    },
})

For rust-analyzer, these 2 options must be turned off:

rust-analyzer.checkOnSave.enable = false
rust-analyzer.diagnostics.enable = false

How does it work?

bacon-ls 🐽 reads the diagnostics location list generated by Bacon's export-locations and exposes them on STDIO over the LSP protocol to be consumed by the client diagnostics.

It requires Bacon to be running alongside to ensure regular updates of the export locations.

The LSP client reads them as response to textDocument/diagnostic and workspace/diagnostic.

Thanks

bacon-ls 🐽 has been inspired by typos-lsp.

Commit count: 33

cargo fmt