Aller au contenu
KendorDocs

Quels langages et versions peut utiliser un exercice de code

Pour les auteurs d’exercices ·

Node.js 22, Python 3.12, Go 1.27 et 1.26, Java 21, Rust 1.98, C++ (Clang 23) et PHP 8.3 et 8.4. Choisissez-en un avec runtime.version dans kendor.yaml.

Un exercice Kendor peut s’exécuter avec Node.js 22, Python 3.12, Go 1.27 ou 1.26, Java 21, Rust 1.98, C++ avec Clang 23, ou PHP 8.3 ou 8.4. Vous choisissez le langage à la création de l’exercice et la version avec runtime.version dans kendor.yaml. Un projet peut ajouter d’autres langages à côté du principal avec toolchains.

Langages et versions disponibles aujourd’hui

La valeur de la deuxième colonne est celle que vous écrivez dans runtime.type, et celle de la troisième celle que vous écrivez dans runtime.version, toujours sous forme de chaîne entre guillemets.

Langage runtime.type runtime.version Version exacte Gestionnaires de paquets et outils de build Outils de test
Node.js node "22" 22.23.3 npm, pnpm et yarn (via Corepack), Bun 1.4.2 node --test
Python python "3.12" 3.12.14 pip (pip install --user) pytest 8.3.4 avec pytest-tap : pytest --tap-stream
Go go "1.27", "1.26" 1.27.1, 1.26.8 Modules Go go test -json ./... | kendor-gotest-tap
Java java "21" Temurin 21.0.12.1 Maven 3.9.16, Gradle 9.8.0 Lanceur console JUnit 6.1.3 dans $JUNIT_CONSOLE ; kendor-junit-tap
Rust rust "1.98" 1.98.1 Cargo, Clippy, rustfmt cargo test --color never 2>&1 | kendor-cargo-tap
C++ cpp "23" Clang/LLVM 23.1.2 CMake, Ninja Catch2 3.16.0 dans $CATCH2_DIR ; kendor-junit-tap
PHP php "8.3", "8.4" 8.3.32, 8.4.23 Composer 2.10.3 PHPUnit depuis votre projet, qui écrit le JUnit dans /tmp/kendor-phpunit.xml

Chaque langage est aussi livré avec son serveur de langage, de sorte que l’éditeur propose l’autocomplétion, l’accès à la définition et les erreurs : typescript-language-server, Pyright, gopls, Eclipse JDT LS, rust-analyzer, clangd et Intelephense. Chaque bac à sable dispose en outre de git, make, cmake, ninja, sqlite3 et d’un compilateur C, quel que soit le langage.

Go 1.22 existe aussi, mais il n’est plus proposé pour les nouveaux exercices (voir plus bas).

Comment l’onglet Tests lit les résultats

L’onglet Tests exécute la test.command du service et liste chaque test qu’il trouve. Il lit du TAP (Test Anything Protocol) sur la sortie standard de la commande, ce qui explique que le tableau indique un convertisseur pour la plupart des langages : kendor-gotest-tap, kendor-junit-tap et kendor-cargo-tap sont dans le PATH de chaque bac à sable et transforment la sortie de go test -json, le XML JUnit et la sortie de cargo test en TAP. Envoyez tout le reste de ce que votre build affiche sur la sortie d’erreur standard. PHP fait exception : écrivez le rapport JUnit de PHPUnit dans /tmp/kendor-phpunit.xml avec --log-junit /tmp/kendor-phpunit.xml.

kendor.yaml
version: 1
runtime:
  type: go
  version: "1.27"
services:
  app:
    test:
      command: go test -json ./... | kendor-gotest-tap

Choisir une version

À la création d’un exercice, choisissez son Langage et sa Version. Le langage ne peut plus changer une fois l’exercice créé ; la version, si.

Pour changer la version plus tard, définissez runtime.version dans kendor.yaml, soit dans la boîte de dialogue Configuration d’exécution, soit en modifiant le fichier, puis enregistrez. Gardez le même runtime.type que le langage de l’exercice : la version du fichier n’est utilisée que lorsque les deux correspondent.

Utilisez la version courte du tableau, comme "1.27", et non la version exacte. Kendor vérifie la version à l’enregistrement et liste celles qu’il propose si la vôtre n’en fait pas partie.

Ajouter un second langage

toolchains place d’autres langages dans le même bac à sable, chacun avec son compilateur, ses outils et son serveur de langage. Cette configuration Laravel utilise PHP comme langage principal et ajoute Node.js pour le build des assets Vite :

kendor.yaml
version: 1
runtime:
  type: php
  version: "8.3"
toolchains:
  - type: node
    version: "22"
install:
  commands:
    - composer install --no-interaction --prefer-dist --no-progress
services:
  app:
    dev:
      command: php artisan serve --host $HOST --port $PORT
      port: 8000
  vite:
    install:
      commands:
        - npm ci
    dev:
      command: npm run dev -- --port $PORT
      port: 5173
preview:
  service: app

Chaque langage ne peut apparaître qu’une seule fois dans runtime et toolchains réunis.

Versions retirées

Lorsqu’une version n’est plus maintenue en amont, Kendor cesse de la proposer pour les nouveaux exercices mais continue de la faire fonctionner. Un exercice déjà sur cette version continue de marcher et de s’enregistrer, et sa liste Version l’affiche comme « plus proposée ». Vous ne pouvez pas choisir une version retirée pour un nouvel exercice. Go 1.22 est retiré aujourd’hui.

Quand vous êtes prêt, faites passer l’exercice à une version actuelle en modifiant runtime.version.

Fichier unique ou projet complet

Quand vous ajoutez un exercice de code, vous choisissez entre deux types :

  • Exercice à fichier unique : le candidat modifie un seul fichier, comme solution.py, et lance depuis l’onglet Tests les tests que vous avez écrits. Il n’y a pas d’aperçu, seulement l’éditeur, un terminal et les tests. Chaque langage du tableau dispose d’un modèle à fichier unique pour démarrer.
  • Exercice de code : un projet complet. Partez d’un modèle ou d’un espace de travail vierge, importez un zip, ou importez un dépôt. Il peut avoir un aperçu, plusieurs services, des bases de données et plusieurs langages.

Quand vous créez un exercice, Partir de liste les modèles du langage choisi : Projets (une application exécutable, sans énoncé pour l’instant), Exercices (un énoncé, du code et des tests prêts à envoyer) et les modèles enregistrés par votre organisation. Les projets disponibles aujourd’hui pour un projet complet sont :

Langage Projets
Node.js Vite + React (TypeScript), Vite + React (JavaScript), Express + PostgreSQL + Valkey
Python Flask, FastAPI
Go net/http, Application en ligne de commande
Java Spring Boot, Services Java + Go + C++
Rust axum
C++ Application en ligne de commande (CMake)
PHP Laravel 11, PHP simple

Chaque modèle est livré avec son propre kendor.yaml, et fonctionne donc dès le démarrage du bac à sable. Lisez-le pour voir une configuration qui marche pour ce langage, puis modifiez ce dont vous avez besoin. Votre exercice reçoit sa propre copie : une modification ultérieure du modèle ne change jamais votre exercice.

Cet article vous a-t-il aidé ?