Extension VS Code

L’extension Elide fait de tout dossier contenant un elide.pkl un projet VS Code : elle synchronise les dépendances et les source sets dans le serveur de langage Kotlin, et exécute, teste et débogue via la CLI elide.

Prérequis

L’extension nécessite un espace de travail approuvé : une synchronisation exécute la CLI elide de l’espace de travail.

Installer

curl -LOJ "https://plugins.elide.dev/vscode/files?id=elide.elide"
code --install-extension elide-*.vsix

Help → Get Started → Get started with Elide présente l’installation, le projet, la synchronisation, l’exécution et les tests.

Synchroniser un projet

L’ouverture d’un dossier contenant elide.pkl le synchronise : Elide résout le manifeste, installe les dépendances lorsque le fichier de verrouillage est périmé, et écrit workspace.json pour le serveur de langage Kotlin. Ajoutez workspace.json à .gitignore.

Cliquez sur l’élément de la barre d’état pour ouvrir le menu Elide : synchroniser, exécuter une commande, exécuter tous les tests, ouvrir elide.pkl ou la sortie. Quand elide.pkl change, l’extension propose de recharger (elide.sync.onManifestChange).

La barre latérale Elide

La vue Elide de la barre d’activité liste chaque projet :

Intelligence de code

La complétion, la navigation et les diagnostics Kotlin et Java viennent du serveur de langage Kotlin, qui importe le workspace.json synchronisé : un module par source set, chaque bibliothèque avec ses sources, le JDK et les options Kotlin du manifeste.

• Les JAR de sources sont installés pour les paquets Maven déclarés, si bien que Go to Definition ouvre le code de la bibliothèque (elide.install.classifiers).
• Le JDK provient de elide.jdk.home, puis de jvm.javaHome, de $JAVA_HOME ou d’un JDK installé correspondant à jvm.target.
• Un dépôt peut conserver un répertoire .idea d’IntelliJ : l’extension définit intellij.buildTool à json dans les paramètres de l’espace de travail, pour que chaque éditeur lise son propre modèle.

Exécuter

Les code lens exécutent ce que le projet déclare :

Les exécutions sont des tâches VS Code de type elide ; les erreurs du compilateur deviennent des entrées de Problems sur le fichier et la ligne signalés.

Dans .vscode/tasks.json :

{ "type": "elide", "command": "test", "args": ["src/api"], "options": { "bail": 3 } }

Tester

Les tests JUnit des source sets de test apparaissent dans la vue Testing, avec des icônes dans la gouttière sur chaque classe et chaque méthode. Une exécution appelle elide test --reporter=tap pour la sélection et rapporte chaque test dès qu’il se termine ; un échec affiche son message d’assertion et renvoie à la ligne en échec.

Le profil Debug exécute les mêmes tests sous le débogueur.

Run with Coverage exécute la sélection avec --coverage et affiche le résultat dans la gouttière de l’éditeur et dans la vue Test Coverage : JavaScript et TypeScript à partir de LCOV, Java et Kotlin à partir d’un rapport XML JaCoCo. Demandez le rapport XML dans elide.pkl :

import "elide:Coverage.pkl" as Coverage

coverage {
  jvm {
    reports { Coverage.xmlReport() }
  }
}

Déboguer

Debug with Elide lance elide run --debugger et s’y attache. Les points d’arrêt dans les sources Kotlin et Java arrêtent le programme ; terminer la session arrête Elide.

Dans .vscode/launch.json :

{
  "type": "elide",
  "request": "launch",
  "name": "Elide: Run (debug)",
  "entrypoint": "src/main/kotlin/shop/Main.kt"
}

elide.debug.adapter choisit le débogueur : intellij (par défaut, fourni par l’extension Kotlin) ou java (Debugger for Java). Le débogueur écoute sur le port 5005, donc une seule session peut s’exécuter à la fois. Pour le débogage CDP et DAP de JavaScript, TypeScript et Python, voir Débogage.

Native Image

Le type de lancement elide-native construit un artefact Native Image et débogue le binaire sous GDB, via l’extension C/C++ (ms-vscode.cpptools) :

{ "type": "elide-native", "request": "launch", "name": "Elide: Debug Native Image", "artifact": "bin" }

Ajoutez -g aux options.flags de l’artefact dans elide.pkl pour des points d’arrêt au niveau du source ; les informations de débogage ne sont émises que sous Linux. program débogue un binaire existant, build: false saute le build.

Espaces de travail

Un manifeste avec workspace.members se synchronise comme un seul build. Chaque membre est un projet dans la barre latérale, la vue Testing, les tâches et les configurations de lancement, et l’intelligence de code suit les dépendances project("name") entre membres sans build. À l’ouverture du répertoire d’un membre, l’extension propose d’ouvrir la racine de l’espace de travail. Voir Espaces de travail.

Paramètres