Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- howto:git:template [2026/08/17 08:51] – Sync aus BZZ-Commons/pygrader50 (v2.1.2) admin
+++ howto:git:template [2026/08/25 10:06] (aktuell) – Veraltet - Inhalt jetzt unter github.com/BZZ-Commons/pygrader50/docs admin
@@ Zeile 1: / Zeile 1: @@
-====== Template-Repositories ======
-Ein **Template-Repository** enthält den Startcode einer Aufgabe. Classroom 50
-kopiert es beim Annehmen in ein privates Repository der lernenden Person. Die
-Python-Templates der BZZ liegen in der Organisation ''templates-python''.
-===== Aufbau =====
-<code>
-<SLUG>/
-├── .github/
-│   └── autograding/          ← Bewertungs-Konfiguration (Fallback)
-│       ├── unittests.json
-│       ├── lint.json
-│       └── pylintrc
-├── tests/                    ← die Tests der Lehrperson
-│   └── test_*.py
-├── main.py                   ← Startcode / Stub
-├── requirements.txt          ← für die lokale Arbeit der Lernenden
-└── README.md                 ← Aufgabenstellung
-</code>
-<WRAP center round important 90%>
-**Kein ''.github/workflows/classroom.yml''.** Der Bewertungs-Workflow kommt
-unter Classroom 50 zentral aus dem Config-Repo. Bleibt die alte Datei liegen,
-laufen bei jedem Push zwei Autograder nebeneinander — siehe
-[[.:classroom50:migration|Migration]].
-</WRAP>
-===== Namensregeln =====
-Der Repository-Name ist der **Slug** der Aufgabe. Er wird an drei Stellen
-identisch verwendet:
-  - Name des Template-Repos
-  - ''slug'' in ''<CLASSROOM>/assignments.json''
-  - Name der Aktivität //External Assignment// in Moodle
-Kleinbuchstaben, Bindestriche als Trenner, Modul und Lerneinheit voran:
-<code>
-m323-lu01-a02-imperativer-ggt
-m320-lu04-a4-objektkommunikation
-</code>
-<WRAP center round tip 90%>
-Gegenüber GitHub Classroom entfällt die alte Einschränkung, dass der Name keine
-Bindestriche enthalten darf. Classroom 50 arbeitet durchgehend mit Slugs.
-</WRAP>
-===== Neues Template anlegen =====
-  - Repository in ''templates-python'' erstellen und unter **Settings → Template repository** als Template markieren.
-  - Startcode, Tests und ''README.md'' mit der Aufgabenstellung einfügen.
-  - ''.github/autograding/'' mit ''unittests.json'', ''lint.json'' und ''pylintrc'' anlegen — Aufbau siehe [[.:classroom50:bewertung|Wie bewertet wird]].
-  - Aufgabe in ''<CLASSROOM>/assignments.json'' des Config-Repos eintragen, mit ''"autograder": "default"'' und ohne ''tests''-Block.
-  - In Moodle eine Aktivität //External Assignment// mit demselben Slug anlegen, siehe [[.:classroom50:moodle|]].
-===== requirements.txt =====
-Die Datei ist für die **lokale** Arbeit der Lernenden da. Die Bewertung auf
-GitHub installiert sie bewusst nicht: pygrader50 bringt eigene Abhängigkeiten
-mit, exakt gepinnt in seiner ''pyproject.toml'', damit die Bewertung
-reproduzierbar bleibt.
-Die alten Pins ''pytest==8.3.3'' und ''pylint==3.2.7'' sind auf Python 3.14
-nicht mehr lauffähig. Wer die Datei pflegt, sollte sie deshalb auf aktuelle
-Versionen heben — sonst weicht die lokale Umgebung der Lernenden von der
-Bewertung ab.
-===== Änderungen an einem Template =====
-<WRAP center round important 90%>
-**Template-Änderungen erreichen bestehende Repositories nicht.** Ein Studi-Repo
-trägt seine Kopie aus dem Moment der Annahme. Eine korrigierte ''unittests.json''
-muss also entweder in die bereits angenommenen Repos nachgezogen werden — oder,
-besser, als Bundle ins Config-Repo wandern, wo sie sofort für alle gilt.
-</WRAP>
-Das ist das stärkste Argument für die Bundles unter
-''<CLASSROOM>/autograders/<SLUG>/'': Eine Korrektur dort wirkt beim nächsten
-Push für die ganze Klasse.
-===== Weiter =====
-  * [[.:classroom50repo|Das classroom50-Repository]]
-  * [[.:classroom50:bewertung|Wie bewertet wird]]
-  * [[howto:pycharm:template|PyCharm-Template]]