Installation/Update

Basic Components

We have these three components to install:

• Wollok-CLI (the language interpreter)
• IDE (Visual Studio Code)
• Extensions (developed for VSCode)

Wollok CLI

The language interpreter is Wollok-CLI (Command Line Interface). It is the executable that runs Wollok programs. There are two ways to install it:

• Via Node (recommended for personal computers)

Recommended

This is the recommended way to install Wollok, as it is the simplest variant, has an agile update method, and includes optimizations that improve performance. If you encounter issues, you can download the latest non-updated executable here.

IDE

The recommended Integrated Development Environment (IDE) is Visual Studio Code (VSCode), as it has extensions that make learning to program with Wollok more enjoyable. However, the source code is simply text and can be edited with any editor.

Install VSCode.

I already have VSCode installed, can I use the one I have?

It is recommended that you download the latest version of VSCode: as of today, the minimum VSCode version required by the Wollok extension is 1.80 (June 2023) or later, but some features like REPL execution or tests may not appear in older versions.

Extensions

These instructions for installing and configuring Wollok extensions for VSC are independent of your machine’s operating system.

1. Open VSCode

2. Install the extensions wollok-lsp-ide and wollok-highlight available in the links or directly from the VSCode Marketplace. The order in which you install the extensions doesn’t matter.

You can go to the Extensions tab, search for ‘wollok’ and install them as shown in this image:

3. If everything went well, you should be able to see both extensions installed in your VSCode:

4. Now you need to configure the extension so it can use Wollok-CLI to run programs.

• Go to the “settings” tab in VSCode: Ctrl + , or from the menu: Code -> Preferences -> Settings. And search for wollok.

• The first setting that will appear is to indicate the path where Wollok Command Line Interface (CLI) is located. For this, you need to enter in the field: wollok.

• There are also other configurations, such as selecting the language in which you want error messages to be displayed.

• At the end it should look something like this:

Done!

You should now be able to use VSCode with Wollok.

Tutorial Videos (in Spanish)

Windows

Linux

Next Steps

What’s next?

• You can see how to create a Wollok project from scratch.
• You can download an example and try it out.
• If you already have a Wollok project in your VSCode, we recommend taking the Tour of the tools we support to get the most out of the IDE.
• If you have questions about the language, you can go to the documentation.