Skip to content

A language server for the Kerboscript (kOS) a language for Kerbal Space Program

License

Notifications You must be signed in to change notification settings

krisavi/kos-language-server

 
 

Repository files navigation

kOS Language Server

Build Status Azure DevOps tests Azure DevOps coverage (branch)

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

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.

About

A language server for the Kerboscript (kOS) a language for Kerbal Space Program

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 99.7%
  • JavaScript 0.3%