Extension VS Code

AlgoLab dispose d'une extension VS Code qui transforme l'éditeur en un environnement de développement complet pour le pseudo-code.

Installation de l'extension

Méthode 1 : Depuis le fichier VSIX

1. Téléchargez algolab-vscode.vsix depuis les Releases GitHub
2. Dans VS Code, ouvrez la palette de commandes : Ctrl+Shift+P (ou Cmd+Shift+P sur macOS)
3. Tapez Extensions: Install from VSIX...
4. Sélectionnez le fichier .vsix téléchargé
5. Redémarrez VS Code

Méthode 2 : Depuis le code source (développeurs)

cd AlgoLab/vscode-extension
npm install
npx @vscode/vsce package

Puis installez le .vsix généré comme décrit ci-dessus.

Fonctionnalités

Coloration syntaxique

L'extension reconnaît automatiquement les fichiers .algo et applique une coloration syntaxique adaptée :

• Mots-clés (bleu) : Variable, Debut, Fin, Si, Alors, Pour, TantQue, etc.
• Types (vert) : Entier, Reel, Caractere, Booleen, Chaine
• Littéraux (orange) : nombres, chaînes de caractères, Vrai, Faux
• Opérateurs : <-, +, -, *, /, comparateurs
• Identifiants : noms de variables et fonctions

Snippets (raccourcis de code)

L'extension fournit des snippets pour les structures courantes. Tapez le préfixe et appuyez sur Tab :

Chaque snippet place le curseur aux bons endroits avec des champs éditables (tabulation pour passer au suivant).

Commande : Exécuter AlgoLab

Raccourci : bouton ▶️ dans la barre d'outils (visible pour les fichiers .algo)

Palette de commandes : Exécuter AlgoLab

Cette commande sauvegarde le fichier actif, ouvre un terminal intégré nommé "AlgoLab execution", et lance algolab sur le fichier. Si le programme utilise Lire, vous pouvez saisir vos entrées directement dans ce terminal.

Commande : Vérifier AlgoLab

Raccourci : bouton ✓ dans la barre d'outils (visible pour les fichiers .algo)

Palette de commandes : Vérifier AlgoLab

Cette commande lance une vérification syntaxique du fichier sans l'exécuter. Les erreurs détectées apparaissent comme des diagnostics dans l'éditeur (soulignement rouge avec message au survol).

Diagnostics automatiques à la sauvegarde

Par défaut, chaque fois que vous sauvegardez un fichier .algo (Ctrl+S), l'extension lance automatiquement une validation et affiche les erreurs détectées comme diagnostics. Les erreurs syntaxiques et sémantiques apparaissent directement dans l'éditeur avec leur position exacte (ligne et colonne).

Les types de diagnostics :

• Erreur (rouge) : erreurs syntaxiques et sémantiques
• Avertissement (jaune) : erreurs d'exécution détectées lors de la validation

Les diagnostics sont automatiquement nettoyés quand le fichier est corrigé ou fermé.

Configuration

L'extension expose trois paramètres dans les settings VS Code (Ctrl+,) :

algolab.executablePath

• Type : chaîne de caractères
• Défaut : "algolab"
• Description : Chemin vers l'exécutable AlgoLab. Si AlgoLab est dans votre PATH, le défaut suffit. Sinon, spécifiez le chemin complet.

Exemples :

"algolab.executablePath": "algolab"                          // Dans le PATH
"algolab.executablePath": "/usr/local/bin/algolab"           // Linux/macOS
"algolab.executablePath": "C:\\AlgoLab\\algolab.exe"         // Windows

algolab.diagnosticsOnSave

• Type : booléen
• Défaut : true
• Description : Active ou désactive la validation automatique à chaque sauvegarde.

Mettez false si vos programmes utilisent Lire (la validation tenterait d'exécuter le programme et resterait bloquée en attente d'entrée).

algolab.diagnosticsTimeoutMs

• Type : nombre (millisecondes)
• Défaut : 3000
• Minimum : 500
• Description : Durée maximale de la validation. Si le timeout est atteint (par exemple à cause d'une boucle infinie ou d'un Lire bloquant), un avertissement est affiché.

Prérequis

L'extension nécessite que l'exécutable algolab soit installé et accessible. Si ce n'est pas le cas, un message d'erreur s'affiche :

Impossible d'exécuter AlgoLab. Vérifiez algolab.executablePath et votre PATH.

Suivez le guide d'installation pour installer AlgoLab.

Dépannage de l'extension