Skip to content

xlab-si/template-library-vscode-plugin

Repository files navigation

Template Library plugin for VS Code/Eclipse Che Theia

This repository allows you to set up VS Code/Eclipse Che Theia Template Library plugin. If you are totally unfamiliar with TPS you can take a look at the Template Library documentation.

Aspect Information
Documentation Template Library plugin documentation
Open VSX Registry Open VSX Registry plugin link
Visual Studio Marketplace VS Marketplace plugin link
Video Template Library with Eclipse Che

Table of Contents

Installation and publishing

This is originally a Visual Studio Code extension/plugin, so the best way to test it locally is to through VS Code's extension development host. RADON IDE is represented by Eclipse Che which uses an open-source cloud and desktop IDE framework called Eclipse Theia within the workspaces. Eclipse Theia is very similar to VS Code and therefore VS Code extensions can be also used in Theia.

VS Code installation

The plugin can be installed through Visual Studio Marketplace here: VS Marketplace plugin link.

To install the plugin without the VS Marketplace to your VS Code editor you will need the latest vsix plugin package, which you can download get here: VS Marketplace plugin link (or check Releases). Then you just have to import the vsix file to the VS Code plugins and after that you will be able to use the plugin in any VS Code window.

Eclipse Che Theia installation

TPS plugin was primarily meant for usage in Eclipse Theia which is the main editor in the Eclipse Che/RADON IDE. THe plugin is available in the Open VSX Registry here: Open VSX Registry plugin link.

To install the plugin manually to Eclipse Che you will need the prepared YAML devfile (which also uses the prepared meta.yaml file). The files to try this can be found in publishing-examples.

Publishing

Here's what you need to do to test the plugin and to package/publish it:

# install Node JS from https://nodejs.org/en/download/
# and test it with node -v and npm -v command

# install prerequisite packages
npm install

# test the plugin in VS Code (this will open a new window with your extension loaded)
press F5 (Run Extension)

# package and publish the extension
# if you don't have npx install it with: npm install npx
npx vsce package

Main features

The extension uses Template Library REST API and can therefore invoke various Template Library actions.

Currently, supported actions are:

  • setting Template Library REST API endpoint
  • creating and publishing TOSCA template or CSAR and its version
  • downloading a specific TOSCA template version files
  • deleting saved login info (Keycloak cookies)