Skip to content

TethysL Extension Activation

When activated by VS Code, the TethysL extension looks for the tethysl program to start the TethysL LSP server, in this order:

  1. The tethysl.binaryPath setting, if you have set it to the path of a tethysl executable.
  2. The tethysl program on your PATH.
  3. The version previously installed by the extension under ~/.tethysl/.
  4. Otherwise, the extension automatically downloads the TethysL release for your platform from https://okeanids.mbari.org/dl/tethysl/ and installs it under ~/.tethysl/tethysl-X.Y.Z/. The specific version to be downloaded directly depends on the extension version itself.

The extension then starts the TethysL language server and is ready to use.

Note

Since version 5.0.0, TethysL is a native executable, so no Java installation is needed.

TethysL CLI

The more self-contained extension as described above —that is, in terms of taking care of downloading its own dependencies— has been implemented mainly as a convenience for general users.

However, you may want to have a directly installed TethysL CLI on your system for the following reasons:

  • The VS Code extension will use it right away (as already mentioned);
  • You can use the CLI directly not only for compiling .tl scripts, but also for other various tasks, including use in shell scripts and makefiles (as part of preparations for vehicle deployments), etc.