Installe Wren en local

Découvre comment installer Wren en local pour résoudre les exercices d'Exercism sur ta propre machine

Ce parcours s'appuie tout du long sur Wren Console pour fournir un environnement d'exécution local de Wren. Cela signifie que nous partons du principe que tout le Wren que tu exécuteras sur ton ordinateur passera par Wren Console. Ne confonds pas cela avec la CLI officielle de Wren CLI. Dans un monde parfait, tu pourrais utiliser cet environnement d'exécution, mais il a actuellement plusieurs problèmes différents, ce qui en fait un choix loin d'être optimal pour apprendre Wren avec Exercism.

Wren Console est un fork de Wren CLI : il résout ces problèmes et ajoute des fonctionnalités qui rendent ton apprentissage plus fluide. Pas de panique : les connaissances et les concepts du langage Wren que tu vas apprendre ici s'appliqueront partout où tu voudras utiliser Wren par la suite.

Aperçu de l'installation

  • Installe Git pour disposer de la commande git
  • Installe Wren Console pour disposer de la commande wrenc

Installer Git

Il te faut le binaire git installé et présent dans ton PATH. C'est ainsi que Wren Package installe les paquets (comme la suite de tests dont tu auras besoin pour tester tes exercices, etc.).

  • Windows : le téléchargement officiel de Git est un bon point de départ.
  • Linux : ton gestionnaire de paquets préféré devrait faire l'affaire.
  • Mac : toutes les versions récentes de Mac OS incluent git d'emblée.

Tu peux vérifier que Git est installé avec git --version :

$ git --version
git version 2.31.1

Pas d'inquiétude si ta version exacte diffère, ce n'est généralement pas très important.

Installer Wren Console

Windows

Tu voudras sans doute télécharger la dernière version depuis GitHub. Ensuite, il te faudra la décompresser et copier l'exécutable wrenc dans ton PATH.

Il est aussi possible de compiler depuis les sources avec Visual Studio.

Linux

Tu peux télécharger la dernière version depuis GitHub ou compiler depuis les sources.

wget -c https://github.com/joshgoebel/wren-console/releases/download/v0.3.1/wren-console-v0.3.1-linux.tar.gz
tar xzf wren-console-v0.3.1-linux.tar.gz

Et assure-toi qu'il est disponible dans ton PATH.

cp bin/wrenc /usr/local/bin/

Mac

La façon la plus simple d'installer Wren Console est d'utiliser le tap et la formule Homebrew d'Exercism :

brew tap exercism/wren
brew install wren-console

Sinon, tu peux télécharger la dernière version depuis GitHub et l'installer manuellement comme indiqué dans les instructions pour Linux. Compiler depuis les sources est aussi assez simple si tu maîtrises ce genre de choses.

Tester l'installation

Une fois que tu penses avoir installé le binaire correctement, il est bon de vérifier que tout fonctionne.

  1. Ouvre un terminal (Terminal, cmd, Powershell, bash, ...)
  2. Exécute wrenc -v

Tu devrais voir les versions de wrenc et de Wren s'afficher :

wrenc v0.3.1 (wren v0.4.0)

Remarque : il est important que tu ouvres une fenêtre de terminal nouvelle. Les fenêtres de terminal déjà ouvertes n'ont peut-être pas été rafraîchies à la fin de l'installation. Cela signifie qu'elles ignorent qu'un nouveau programme a été installé.

Aide : 'wrenc' is not recognised

Tu n'as probablement pas placé wrenc dans ton PATH... Sur MacOS et Linux, tu peux modifier ton path en ajoutant ce qui suit à ~/.bash_profile ou ~/.zshrc :

export PATH=/path/to/your/wrenc/:$PATH

Aucune idée si tout ceci est correct. Sur Windows, ouvre le menu Démarrer et recherche « environment variables ». Tu devras modifier l'entrée PATH et y ajouter le chemin vers les binaires wrenc. On les trouve généralement dans C:\Program Files\nodejs. Si tu y navigues avec ton File Explorer, tu devrais trouver node.exe, npm.bat et npx.bat.

Ferme tous les terminaux ouverts et ouvres-en un nouveau.

Prérequis pour les exercices

Suis ces instructions pour télécharger la CLI exercism adaptée à ton système d'exploitation.

Une fois la CLI installée et configurée, télécharge le premier exercice : hello-world :

$ exercism download --exercise=hello-world --track=wren

Chaque exercice a ensuite besoin de quelques paquets Wren pour exécuter les tests. Tu peux les installer en exécutant cette commande depuis le répertoire de l'exercice :

$ wrenc package.wren install