Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Eigener Kurs-Prüfer mit VS-Code-Erweiterung
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Dieser kleine Kurs-Prüfer bewertet eine Python-Aufgabe im Terminal und über einen eigenen VS-Code-Befehl.
Die Anleitung gilt für Ubuntu 26.04 LTS (amd64). Voraussetzung für die Editorintegration ist Visual Studio Code. Die Tests laufen direkt mit deinen Benutzerrechten. Das Beispiel ist für eigene lokale Übungen gedacht und keine Sandbox für fremden Code.
Installation
1. Paketlisten aktualisieren
Lädt die verfügbaren Paketinformationen.
sudo apt update
2. Werkzeuge installieren
Python führt die Tests aus; Node.js und npm bauen die Erweiterung. unzip entpackt den Kurs.
sudo apt install python3 nodejs npm unzip
3. Node.js prüfen
Ubuntu 26.04 liefert Node.js 22.22.1. Verwende für das Paketwerkzeug mindestens Node.js 22.12.
node --version
4. Kursdateien herunterladen
Lade das Beispielarchiv über den Browser nach ~/Downloads herunter. Es enthält den vollständigen eigenen Quellcode, die Aufgabe und ihre Tests. Der Zielordner ~/kurs-pruefer soll noch nicht existieren.
5. Kurs entpacken
Erzeugt ~/kurs-pruefer mit Aufgabe, Tests und Erweiterungsquellen.
unzip ~/Downloads/kurs-pruefer.zip -d ~
6. Kursordner öffnen
Prüfungen werden immer aus diesem Ordner gestartet.
cd ~/kurs-pruefer
7. Ausgangszustand prüfen
Die Aufgabe ist absichtlich unvollständig. Erwartet wird ein Fehler wegen NotImplementedError und ein von null verschiedener Rückgabewert.
python3 -m unittest discover -s tests -p test_aufgabe.py -v
8. Aufgabe bearbeiten
Implementiere quadratsumme(werte): Quadriere jede Zahl und addiere die Ergebnisse. Für eine leere Eingabe ist das Ergebnis 0. Auch Generatoren müssen funktionieren; die Eingabe darf nicht verändert werden. Bearbeite nur aufgabe.py und speichere die Datei.
code aufgabe.py
9. Lösung prüfen
Bei einer richtigen Lösung müssen fünf Tests mit OK enden. Derselbe Befehl wird später von der Erweiterung gestartet.
python3 -m unittest discover -s tests -p test_aufgabe.py -v
10. Erweiterungsordner öffnen
Hier liegt die Paketbeschreibung für VS Code.
cd ~/kurs-pruefer/erweiterung
11. Paketwerkzeug installieren
Installiert vsce nur in diesem Projekt, ohne sudo. Die Erweiterung selbst benötigt keine npm-Laufzeitpakete.
npm install --save-dev @vscode/vsce
12. VSIX bauen
Erzeugt ein lokal installierbares Paket. Die Optionen erlauben einen lokalen Eigenbau ohne Repositoryadresse und ohne festgelegte Weitergabelizenz; es wird nichts im Marketplace veröffentlicht.
npx vsce package --allow-missing-repository --skip-license --out kurs-pruefer-0.1.0.vsix
13. Erweiterung installieren
Registriert das lokale Paket im aktiven VS-Code-Profil. Ein Marketplace-Konto ist nicht erforderlich.
code --install-extension ./kurs-pruefer-0.1.0.vsix
14. Kurs im Editor öffnen
Öffnet ausdrücklich den Kursordner, nicht nur den Unterordner erweiterung. Bestätige das Workspace-Vertrauen nur für diesen selbst geprüften Kurs.
code --new-window ~/kurs-pruefer
15. Kursprüfung starten
Öffne Strg + Umschalt + P und wähle Kurs: Aufgabe prüfen. Die Erweiterung speichert offene Dateien und öffnet einen Python-Testtask. Bei mehreren Arbeitsordnern wird der Zielordner ausgewählt. Im Terminal sollen dieselben fünf Testergebnisse wie zuvor erscheinen.
Installation prüfen
1. Erweiterung anzeigen
Die Ausgabe muss lokale-kurse.kurs-pruefer@0.1.0 enthalten.
code --list-extensions --show-versions
2. Fehlererkennung testen
Baue vorübergehend einen falschen Rückgabewert in aufgabe.py ein. Starte Kurs: Aufgabe prüfen erneut; die Tests müssen scheitern. Stelle danach deine richtige Lösung wieder her und prüfe sie erneut.
Quellcode verstehen
Die Datei tests/test_aufgabe.py enthält fünf Fälle: positive Werte, negative Werte, leere Eingabe, Generator und unveränderte Eingabe. VS Code startet Python über ProcessExecution mit einer festen Argumentliste und dem gewählten Kursordner. Dadurch funktionieren auch Ordnernamen mit Leerzeichen. Die Erweiterung wertet keine Shellbefehle aus Kursbeschreibungen aus. Die Python-Tests selbst führen den Aufgabencode aus.
Der vollständige Quellcode steht im Archiv. Eine zusätzliche fertige VSIX-Datei liegt zum lokalen Installieren bei; die Schritte oben zeigen den eigenen Bau. Der Platzhalter-Herausgeber lokale-kurse ist keine Marketplace-Registrierung. Vor einer Weitergabe eigener Änderungen legst du Lizenz, Herausgeber und Versionspflege selbst fest.
Deinstallieren
1. Erweiterung entfernen
Entfernt die lokale Erweiterung aus dem aktiven Profil.
code --uninstall-extension lokale-kurse.kurs-pruefer
2. Projekt optional entfernen
Sichere vorher deine Lösung. Löscht Aufgabe, Tests und lokale npm-Werkzeuge.
rm -rf -- ~/kurs-pruefer
3. Entfernung prüfen
lokale-kurse.kurs-pruefer darf nicht mehr in der Liste erscheinen.
code --list-extensions
Quellen und Lizenz
Eigener Beispielcode für dieses Buch. Technische Referenzen: VS-Code-Task-API, Paketierung als VSIX, Workspace Trust und Python unittest. Es wird keine Fremdlizenz automatisch auf deinen eigenen Kurs übertragen.
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.