craft-ls 0.4.0

A Language Server Protocol implementation for *craft files.

craft-ls

Get on

craft-ls is a Language Server Protocol implementation for *craft[^1] tools.

craft-ls enables editors that support the LSP to get quality of life improvements while working on *craft configuration files.

Features

Feature	Snapcraft	Rockcraft	Charmcraft[^1]
Diagnostics	✅	✅	✅
Documentation on hover	✅	✅	✅
Symbols	✅	✅	✅
Autocompletion	✅	✅	✅

https://github.com/user-attachments/assets/e4b831b5-dcac-4efd-aabb-d3040899b52b

Usage

Installation

Using uv or pipx

uv tool install craft-ls

pipx install craft-ls

Setup

Helix

# languages.toml
[[language]]
name = "yaml"
language-servers = ["craft-ls"]

[language-server.craft-ls]
command = "craft-ls"

VSCode

The VSCode extension can be installed from the marketplace. It requires a Python 3.12 interpreter. If not automatically picked, you may configure it using the following key:

"craft-ls.interpreter": [
  "/usr/bin/python3.12"
]

TBD: neovim

Roadmap

Project availability:

• Python package
• Snap
• Nix flake
• VSCode extension

Features:

• Diagnostics
• Autocompletion on typing
• Symbol documentation

Ecosystem:

• Encourage *craft tools to refine their JSONSchemas even further

[^1]: snapcraft, rockcraft and partial support for charmcraft (all-in-one charmcraft.yaml only)