Skip to content

VS Code Extension

The TethysL VSCode extension provides advanced editing capabilities for TethysL scripts.

Features include:

  • Complete mission validation, with error highlighting
  • Autocompletions, covering a good part of the language
  • Element information on mouse hover and with links to documentation
  • Script outline
  • Go-to-definition/references navigation:
    • From the use of an argument or output variable to its definition
    • From an argument definition to its usages
    • If the lrauv-application codebase is also available on the system, you can also quickly navigate to the C++ definition of behaviors and settings, units, and universals.
  • Source reformatting
  • Advanced:
    • Optionally, you can enable the automatic generation of XML (.tx extension) upon any successful compilation of the TethysL script. This, in particular, intended to facilitate inspection by users familiar with the XML format.
    • You can also generate TethysL from existing XML files. This is intended to facilitate the migration of existing mission scripts to the TethysL format.

Prerequisite

You will only need the TethysL CLI installed on your system, in particular, with the tethysl program available via your $PATH environment variable. Please see the CLI section for instructions. (The extension will automatically call the TethysL LSP server included in the TethysL CLI program.)

Note

In the future we may offer a more self-contained extension. At the moment this is not a priority as we presume the CLI is in general also to be used directly on the target system not only to compile .tl scripts but also for other various tasks, including use in makefiles (as part of preparations for vehicle deployments), documentation generation, XML validation, etc.

Using this extension

With the prerequisite in place (i.e., a functional tethysl program on your $PATH), just open a directory containing TethysL mission files in VSCode.

VSCode may automatically recognize the .tl file extension and offer you to install this extension from the VSCode marketplace. In general, you can directly use the Marketplace option in VSCode and enter "tethysl" in the search field:

Pick the latest version available, review the entry, click "Install", and enjoy.

Here's a screencast demonstrating some features initially implemented.

The extension is published at: