Saltearse al contenido
Wollok

Instalación

Pre-requisitos

Tener instalado VSCode.

Wollok Command Line Interface

  1. Descargar la Wollok Command Line Interface (CLI) disponible para Linux, MacOS (versión arm64) y Windows.

  2. Luego vamos a renombrar el ejecutable a wollok (o wollok.exe) para facilitar su uso desde una terminal y lo ubicaremos dentro del PATH de nuestro sistema operativo para que lo reconozca desde cualquier carpeta. A continuación te dejamos las instrucciones para cada caso.

Windows

Teniendo en cuenta que en la carpeta Downloads del usuario logueado nos descargamos la versión de Wollok TS CLI de Windows y que el usuario se llama Usuario, haremos lo siguiente

  • crear una carpeta Wollok dentro del home del usuario (en este caso: C:\Users\Usuario)
  • mover el archivo de la carpeta C:\Users\Usuario\Downloads a C:\Users\Usuario\Wollok. Es importante dejarlo dentro de las carpetas del usuario logueado para no tener problemas de permisos.
  • renombrar el ejecutable a wollok.exe para que sea más comodo de utilizar

wollok-ts-cli-path-win-2

Por último vamos a agregar la carpeta Wollok que acabamos de crear a la lista de carpetas que forman parte de nuestro PATH. Para eso abrimos la configuración de variables de entorno:

  • activamos la ventana de ejecución de comandos con las teclas Windows y R
  • escribimos sysdm.cpl que es el programa que levanta el Panel de Control

Activar variables de entorno

  • una vez posicionada en la solapa “Avanzados”, presionamos el botón “Variables de entorno” (Environment variables)
  • en la primera de la listas (la que corresponde al usuario logueado), seleccionamos la variable Path (puede ser que tengas que scrollear para encontrarla) y luego presionamos el botón “Editar” (Edit)
  • hay que seleccionar con el mouse la primera línea vacía y escribimos allí la dirección de la carpeta donde dejamos el ejecutable, en nuestro caso C:\Users\Usuario\Wollok
  • hacemos click en “Ok” y nuevamente en “Ok” dos veces para salir

Variables de entorno avanzadas

Para comprobar que el CLI se instaló correctamente nos posicionamos en una carpeta diferente a C:/Users/Usuario/Wollok y ejecutamos wollok --version en cualquier terminal (podés usar Powershell, CMD o Git Bash, el resultado es el mismo):

Verificación wollok ts cli

Linux

  • Para este punto vamos a necesitar levantar una terminal con Ctrl + Alt + T o buscando Terminal en la barra de herramientas

  • Asumimos que descargaste la versión del cli en la carpeta ~/Downloads (~ es la carpeta raíz del usuario logueado). Desde aquí vamos a renombrar el archivo ejecutable y le vamos a dar permisos de ejecución:

Terminal window
cd ~/Downloads
ls -la wollok-ts-cli*
mv ./wollok-ts-cli* ./wollok
chmod a+x ./wollok
sudo mv ./wollok /usr/local/bin/wollok # te va a pedir la clave de usuario root
ls -la /usr/local/bin/wollok

Te mostramos cómo se hace esta parte desde una terminal:

wollok-ts-cli-linux-cmd

Lo que hacemos es renombrar el archivo a wollok, darle permisos de ejecución (chmod a+x), pasarlo a la carpeta /usr/local/bin y confirmar con ls -la que el archivo está en ese directorio. El archivo debe tener las tres x correspondientes a los permisos de ejecución.

Para verificar que está correctamente instalado, escribimos wollok --version en la consola desde cualquier carpeta, y nos debe devolver el número de versión (también podemos ejecutar wollok --help):

Verificación Linux wollok ts cli

Mac

  • Para este punto vamos a necesitar levantar una terminal con ⌘ (Cmd) + Espacio o buscando Terminal en el Launchpad

  • Asumimos que descargaste la versión del cli en la carpeta ~/Downloads (~ es la carpeta raíz del usuario logueado). Desde aquí vamos a renombrar el archivo ejecutable y le vamos a dar permisos de ejecución:

Terminal window
cd ~/Downloads
ls -la wollok-ts-cli*
mv ./wollok-ts-cli* ./wollok
chmod a+x ./wollok
sudo mv ./wollok /usr/local/bin/wollok # te va a pedir la clave de usuario root
ls -la /usr/local/bin/wollok

Te mostramos cómo hacerlo desde una terminal de Mac:

Rename & give access to wollok ts cli executable in Mac

Lo que hacemos es renombrar el archivo a wollok, darle permisos de ejecución (chmod a+x), pasarlo a la carpeta /usr/local/bin y confirmar con ls -la que el archivo está en ese directorio. El archivo debe tener las tres x correspondientes a los permisos de ejecución.

Para verificar que esté correctamente instalado, ecesitamos algunos pasos más gracias al mecanismo de seguridad que trae el sistema operativo Mac:

  • debemos ejecutar wollok --version la primera vez
  • va a aparecer una ventana avisando que no puede ejecutarlo, hacemos click en la opción Show in Finder
  • en el Finder hacemos click derecho y en las opciones, nuevamente Open
  • eso abre una Terminal, y una nueva ventana de confirmación. Esta vez en lugar de Show in Finder seleccionamos Open
  • ahora sí termina de ejecutarse el comando: cerramos la terminal que nos abrió Mac y volvemos a nuestra terminal original
  • a partir de ahora ya podemos ejecutar wollok --version normalmente

Execute wollok ts cli

Extensiones de Wollok para VSC

Estas instrucciones son independientes del sistema operativo de tu máquina.

  1. Abrir el VSCode

  2. Instalar las extensiones wollok-lsp-ide y wollok-highlight disponibles en los links o directamente desde el Marketplace del VSCode. El orden en el que instales las extensiones es indistinto.

Podés ir a la tab de Extensiones, buscar ‘wollok’ e instalarlas como muestra esta imagen:

Download VSCode Wollok Extensions

  1. Si todo salió bien deberías poder ver ambas extensiones instaladas en tu VSCode:

Check extensions in Visual Studio Code

image

Configuración

Ahora es necesario configurar la extensión para que pueda usar Wollok-CLI para correr programas.

  1. Ir a la pestaña de “ajustes” (o “settings” en inglés) del VSCode: Ctrl + , o desde el menú: Code -> Preferencias -> Ajustes. Y buscar por wollok.

  2. El primer ajuste que aparecerá es para indicar el path donde se encuentra Wollok Command Line Interface (CLI). Para eso es necesario 1. utilizar el nombre “wollok” si seguiste los pasos de instalación o bien 2. copiar la dirección absoluta del ejecutable que te descargaste antes y pegarlo en el campo.

  1. También hay otras configuraciones, como seleccionar el idioma en que querés que se muestren los mensajes de errores.

  2. Al final debería verse algo así:

Settings

¡Listo!

Ya deberías poder usar VSCode con Wollok.

Próximos pasos

¿Cómo seguimos?