JFryy/systemd-lsp: a language server implementation for systemd unit files made in rust 🦀

A Language Server Protocol (LSP) implementation for systemd unit files, providing editing support with syntax highlighting, diagnostics, autocompletion, and documentation.

• Syntax Analysis – Complete parsing of systemd unit file structure
• Diagnostics – Error detection and validation for sections, directives, directive fields and warnings for non-conventional configurations
• Autocompletion – Context-aware suggestions for sections and directives
• Rich Documentation – Comprehensive hover information and goto definition
• Code Formatting – Formatting of unit files

• Rust toolchain (install via rustup)

git clone https://github.com/jfryy/systemd-lsp.git
cd systemd-lsp
cargo build --release

The binary will be available at target/release/systemd-lsp.

The project is built using Cargo, Rust’s package manager. The --release flag optimizes the build for performance. For development, you can use cargo build for faster compilation times with debug information.

Add this configuration to your Neovim setup:

-- Automatically set filetype and start LSP for specific file patterns
vim.api.nvim_create_autocmd("BufEnter", {
    pattern = "*.service",
    callback = function()
        vim.bo.filetype = "systemd"
        vim.lsp.start({
            name = 'systemd_ls',
            cmd = { '/path/to/systemd-lsp' }, -- Update this path to your systemd-lsp binary
            root_dir = vim.fn.getcwd(),
        })
    end,
})

Replace /path/to/systemd-lsp with the actual path to your built binary.

You can run the language server directly, although there is little reason to do so except for debugging purposes. An editor typically starts and stops the server implicitly.

./target/release/systemd-lsp

• Embedded Documentation – All manual pages built into the binary
• No External Dependencies – Single binary with everything included
• Cross-Platform – Works on Linux, macOS, and Windows
• LSP Standard Compliant – Compatible with all LSP-capable editors

This project is designed to simplify the editing of Unit files by providing validation, autocompletion, and formatting features commonly available for modern languages and file formats. Inspired by systemd-language-server, it offers enhanced functionality and improved performance, leveraging Rust’s memory safety and efficiency.

Contributions always welcome.