kOS Language Server

A language server for Kerboscript within the KOS mod for Kerbal Space Program. A language server can provide features typical to an IDE language for the supported target language, in this case Kerboscript.

The project currently supports the following clients

• Visual Studio Code via the kOS extension
• Vim via kerbovim
• Atom only with syntax highlight via the kos-ide plugin

For additional client support such as sublime text, emacs, notepad++ or others please post an issue with the requested editor.

Features

Currently the vscode client 0.12.0 implements the follow features

• syntax highlighting
• brace detection
• code snippets
• diagnostics on parsing errors
• go to definition and symbols and run statements
• symbol auto complete
• suffix auto complete
• manual completion triggering
• rename symbol
• unreachable code detection
• function signature help
• file symbol lookup
• identify symbols that don't exist
• identify unused symbols
• identify symbols that shadow (hide) an existing variable
• identify symbols that may not exist at runtime
• on hover type definitions (experimental)
• full workspace loading and change propagation
• foldable regions with \\ #region and \\ #endregion
• documentation searching

Commands

All commands can be launched with ctrl+shift+p

• launch kerbal space program kOS: Start Kerbal Space Program
• launch telnet client using kOS: Connect Telnet Client
• Route server logging to LSP inspector kOS: Route Logging to LSP inspector
• Route server logging to Vscode kOS: Route Logging to Vscode
• Search kOS Documentation kOS: Search Documentation

Settings

These settings are currently included with the tool

• kos-vscode.kerbalSpaceProgramPath Path to kerbal space program
• kos-vscode.completionCase Indicate the preferred completion case for built in symbols
• kos-vscode.telnetHost Host name of the telnet server
• kos-vscode.telnetPort Host port of the telnet server
• kos-vscode.lspPort Port to send lsp message to for the LSP Inspector
• kos-vscode.trace.server
  • verbosity Detail level of the logs
  • format Log format
  • level Message level

Influence

This project is heavily inspired by the crafting interpreters series. Definitely check it out if your interested in creating your own language, or language tooling.