CodeCampus pour VS Code

Faites vos exercices Python CodeCampus dans VS Code : l'extension teste votre code avec le Python de votre ordinateur, puis envoie la réponse à la plateforme quand les tests réussissent. La question est validée comme si vous l'aviez faite en ligne.

• Choisissez un exercice et une question sans quitter l'éditeur, l'énoncé est inséré en commentaire.
• Testez votre réponse en un clic, avec les mêmes tests que sur la plateforme.
• Gardez plusieurs questions, voire plusieurs exercices, dans un même fichier.

Seules les questions Python se font dans VS Code. Les autres (SQL, réponses courtes…) restent sur la plateforme.

L'extension s'utilise avec un compte sur une plateforme CodeCampus.

Avant de commencer

• Un compte sur une plateforme CodeCampus (par exemple https://app.codecampus.fr).
• Python 3.8 ou plus récent installé sur votre ordinateur. Sous Windows, cochez « Add python.exe to PATH » pendant l'installation.

L'extension Python de Microsoft n'est pas obligatoire, mais elle est recommandée pour la coloration et l'autocomplétion.

Installation

Dans VS Code, ouvrez l'onglet Extensions (Ctrl+Shift+X), cherchez CodeCampus et cliquez sur Installer.

Si votre enseignant vous a donné un fichier .vsix : onglet Extensions → menu … → Install from VSIX… et choisissez le fichier. Pour une mise à jour, installez le nouveau fichier par-dessus, sans désinstaller l'ancien : votre connexion est conservée.

Se connecter à la plateforme

1. Sur la plateforme, ouvrez le menu de votre compte → Tokens API (VS Code), puis créez un token. Copiez-le tout de suite : il ne sera plus affiché ensuite.
2. Dans VS Code, Ctrl+Shift+P → CodeCampus: Configurer la connexion.
3. Saisissez l'adresse de la plateforme, telle qu'elle apparaît dans votre navigateur (ex. https://app.codecampus.fr), puis collez le token.

En bas à gauche de VS Code, la barre d'état affiche CodeCampus · votre identifiant. Un clic dessus ouvre le menu du compte : changer de compte, diagnostic, déconnexion.

Le token est personnel : ne le partagez pas. Vous pouvez le supprimer à tout moment depuis la même page de la plateforme ; il cesse alors de fonctionner.

Traiter une question

1. Insérer la question

Ouvrez ou créez un fichier .py, puis cliquez sur le logo CodeCampus en haut à droite de l'éditeur (ou Ctrl+Shift+P → CodeCampus: Insérer une question CodeCampus).

Choisissez l'exercice (ils sont regroupés par module, le module en cours en premier) puis la question. L'extension ajoute dans le fichier :

# codecampus: exercice=12 question=3
# Les listes — question 3
# Écrire une fonction moyenne(notes) qui renvoie la moyenne des notes.

La première ligne est le tag : c'est lui qui indique à l'extension à quelle question correspond votre code. Ne le modifiez pas.

2. Écrire votre réponse

Écrivez votre code sous le tag. Vous pouvez l'exécuter normalement pour le mettre au point (▷ de l'extension Python, terminal…).

3. Tester et envoyer

Au choix :

• cliquez sur CodeCampus : tester et envoyer la Q3, juste au-dessus du tag ;
• cliquez sur Envoyer la Q3 à CodeCampus dans la barre d'état ;
• cliquez sur l'icône d'envoi (nuage avec une flèche) en haut à droite de l'éditeur.

L'extension enregistre le fichier, lance les tests de la question avec votre Python, puis :

• si les tests réussissent, envoie votre code à la plateforme : la question est validée et le lien au-dessus du tag affiche « Déjà validée » ;
• sinon, affiche l'erreur et n'envoie rien. Voir le détail ouvre le panneau de sortie CodeCampus, avec vos print et le message d'erreur Python.

Vous pouvez renvoyer une question déjà validée, par exemple après avoir amélioré votre code : c'est la dernière version envoyée qui est conservée.

Plusieurs questions dans un même fichier

Un fichier peut contenir autant de questions que vous voulez, même d'exercices différents :

# codecampus: exercice=12 question=1
def somme(a, b):
    return a + b

# codecampus: exercice=12 question=2
def moyenne(notes):
    return sum(notes) / len(notes)

# codecampus: exercice=15 question=1
...

Le code d'une question va de son tag jusqu'au tag suivant (ou jusqu'à la fin du fichier).

• Ajouter une question : clic droit dans l'éditeur → Insérer une question CodeCampus (le logo en haut de l'éditeur n'apparaît que dans un fichier sans question). La nouvelle question est ajoutée à la fin du fichier. Si elle y est déjà, l'extension place simplement le curseur dessus.
• Choisir la question à envoyer : le lien au-dessus d'un tag envoie toujours cette question-là. Le bouton de la barre d'état et l'icône en haut de l'éditeur envoient la question où se trouve le curseur ; la barre d'état indique laquelle.

Important : chaque question est testée seule. Seul le code situé entre son tag et le tag suivant est utilisé. Un import placé en haut du fichier, ou une fonction écrite dans une autre question, n'est pas pris en compte : recopiez-le dans le bloc de la question qui en a besoin, sinon le test échoue avec une erreur NameError.

Pour les enseignants

Avec un token créé depuis un compte enseignant, l'extension propose les exercices des modules de vos groupes et exécute les tests, mais rien n'est enregistré : pratique pour vérifier un énoncé ou montrer l'extension en classe. La barre d'état affiche alors « (enseignant) ».

Réglages

Le token n'est pas un réglage : il est conservé dans le trousseau sécurisé de VS Code.

Commandes

Toutes accessibles par Ctrl+Shift+P, en tapant « CodeCampus » :

En cas de problème

Commencez par CodeCampus: Diagnostic de la connexion : le résultat s'affiche dans le panneau de sortie CodeCampus.

• « Interpréteur Python introuvable » : Python n'est pas installé, ou pas dans le PATH. Installez-le, ou indiquez son chemin dans le réglage codecampus.pythonPath, puis redémarrez VS Code.
• « Token refusé » ou connexion échouée : le token a été supprimé, ou il a été créé sur une autre plateforme que l'adresse configurée. Créez-en un nouveau et relancez Configurer la connexion.
• « Temps limite dépassé » : votre programme tourne plus de 15 secondes. Cherchez une boucle infinie, ou un input() qui attend une saisie que le test ne fournit pas.
• NameError alors que le fichier fonctionne : il manque un import ou une fonction dans le bloc de la question (voir Plusieurs questions dans un même fichier).
• « Cette question n'est pas une question Python » : elle se fait sur la plateforme.
• « Le test de cette question est mal configuré » : le problème vient de l'énoncé, pas de votre code. Prévenez votre enseignant.
• Sous Linux, « impossible d'enregistrer la configuration » : VS Code a besoin d'un trousseau (gnome-keyring, KWallet) pour conserver le token.

Données envoyées

L'extension communique uniquement avec la plateforme que vous avez configurée. Elle charge la liste des exercices et les questions, et n'envoie votre code que lorsque les tests ont réussi : le code de la question testée, et rien d'autre du fichier. Les tests s'exécutent sur votre ordinateur.