DistroRun LSP

Schema-powered autocompletion and validation for DistroRun YAML configuration files.

Overview

DistroRun LSP is a Visual Studio Code extension that provides intelligent editing support for DistroRun configuration files. It delivers real-time validation, context-aware autocompletion, and inline documentation by leveraging a JSON Schema through the Red Hat YAML extension.

Features

• Autocompletion — Context-aware suggestions for configuration keys, values, and enums.
• Validation — Real-time diagnostics for invalid keys, incorrect types, and missing required fields.
• Hover Documentation — Inline descriptions and usage examples on hover.

Requirements

• Visual Studio Code 1.75 or later
• Red Hat YAML (installed automatically as a dependency)

Configuration Reference

The extension validates the following top-level keys in .yaml and .yml files:

Example

version: "1.0"
name: my-server

distro:
  base: fedora
  type: server

packages:
  - nginx
  - vim
  - curl

users:
  - name: root
    password: changeme
  - name: charif
    password: securepass

services:
  enable:
    - nginx
    - sshd

build:
  sbom: true

Development

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Launch the Extension Development Host
# Press F5 in VS Code

License

MIT