Dynamischer Python Checker (JACK3) - Versionsgeschichte

LGlaser: Anleitung für statische Tests hinzugefügt

2026-04-28T06:40:58Z

Anleitung für statische Tests hinzugefügt

← Nächstältere Version		Version vom 28. April 2026, 06:40 Uhr
Zeile 17:		Zeile 17:
	</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.		</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.

	~~===~~ Statische Tests & Codeanalyse ~~===~~		'''Statische Tests & Codeanalyse''': Derzeit gibt es für Python keinen statischen (GReQL-)Checker. Der eingereichte Code kann allerdings indirekt auf Syntaxelemente überprüft werden, indem er händisch geparst wird. Hierzu können die Python-Bordmittel, insbesondere das [https://docs.python.org/3.11/library/ast.html AST (Abstract Syntax Trees)]-Modul für Syntaxbäume genutzt werden.
	Derzeit gibt es für Python keinen statischen (GReQL-)Checker. Der eingereichte Code kann allerdings indirekt auf Syntaxelemente überprüft werden, indem er händisch geparst wird. Hierzu können die Python-Bordmittel, insbesondere das [https://docs.python.org/3.11/library/ast.html AST (Abstract Syntax Trees)]-Modul genutzt werden.

	== ~~Aufbau eines Testtreibers~~ ==		==Testtreiber für den Checker==
	Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)\|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.		Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)\|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.

Zeile 45:		Zeile 44:
	</syntaxhighlight>		</syntaxhighlight>

	===API zum Zurückmelden von Ergebnissen===		===API zum Zurückmelden von Ergebnissen ===
	Innerhalb eines Testfalls werden Ergebnisse über das Modul <code>Trace</code> zurückgeliefert. Dieses Modul sammelt alle Punktzahlen und Feedback auf und berichtet diese am Ende der Ausführung. Es bietet folgende Funktion:<syntaxhighlight lang="python3">		Innerhalb eines Testfalls werden Ergebnisse über das Modul <code>Trace</code> zurückgeliefert. Dieses Modul sammelt alle Punktzahlen und Feedback auf und berichtet diese am Ende der Ausführung. Es bietet folgende Funktion:<syntaxhighlight lang="python3">
	def printResult(result: int, feedback: str = None):		def printResult(result: int, feedback: str = None):
Zeile 57:		Zeile 56:
	</syntaxhighlight>{{Wichtig\|In jedem Testfall muss <code>printResult</code> genau ein Mal tatsächlich aufgerufen werden!}}		</syntaxhighlight>{{Wichtig\|In jedem Testfall muss <code>printResult</code> genau ein Mal tatsächlich aufgerufen werden!}}

	=== Schreiben von Testfällen ===		===Schreiben von Testfällen===
	Der Checker nutzt für das Tracing eine spezielle Kontrollflussanalyse, basierend auf Pythons [https://docs.python.org/3.11/reference/simple_stmts.html#the-assert-statement <code>assert</code>-Schlüsselwort] und Exceptions. Mit <code>assert</code> lassen sich Ausdrücke testen, die resultierende Exception lässt sich anschließend fangen und in Feedback umwandeln.		Der Checker nutzt für das Tracing eine spezielle Kontrollflussanalyse, basierend auf Pythons [https://docs.python.org/3.11/reference/simple_stmts.html#the-assert-statement <code>assert</code>-Schlüsselwort] und Exceptions. Mit <code>assert</code> lassen sich Ausdrücke testen, die resultierende Exception lässt sich anschließend fangen und in Feedback umwandeln.

Zeile 78:		Zeile 77:
	Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.		Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.

	== Ressourcen ==		In Situationen, bei denen die Punktevergabe von anderen Testfällen abhängig ist (z. B. wenn ausschließlich Punkte vergeben werden sollen, wenn statische Checks erfolgreich waren), kann diese Logik auch in einem einzigen Testfall untergebracht werden. Punktzahl und (ggf. konkatenierte) Feedback(s) müssen dann entsprechend vom Testfall zusammengesetzt werden.

			=== Statische Tests===
			Mithilfe des [https://docs.python.org/3.11/library/ast.html AST]-Moduls kann der eingereichte Code in einen Syntaxbaum geparst werden. Dieser Syntaxbaum lässt sich mithilfe von Python-Code prüfen. Der folgende Testfall prüft beispielsweise, ob im eingereichten Code Importe enthalten sind:<syntaxhighlight lang="python3" line="1">
			import Communicator
			import Trace
			import studentcode
			import math
			import ast

			@Communicator.decorator
			def static_check():
			# Parsen in Syntaxbaum
			with open(studentcode.__file__, mode="r", encoding="utf-8") as f:
			source_code = f.read()
			tree = ast.parse(source_code)

			# Über Syntaxbaum iterieren und Importe suchen
			import_detected = None
			for node in ast.walk(tree):
			if isinstance(node, (ast.Import, ast.ImportFrom)):
			import_detected = node.lineno
			print(f"Import in line {import_detected}")

			# Feedback erzeugen
			error_feedback = None
			if import_detected is not None:
			error_feedback = f"In Zeile {import_detected} wurde ein Import erkannt. Die Lösung sollte ohne Importe auskommen."

			# Rückmeldung
			try:
			assert (error_feedback is None)
			Trace.printResult(40) # Statischer Test bestanden
			except Exception:
			Trace.printResult(0, error_feedback) # Statischer Test nicht bestanden

			if __name__ == "__main__":
			static_check()
			</syntaxhighlight>Dieser Test könnte beliebig erweitert werden, z. B. for-/while-Schleifen suchen oder Rekursion prüfen, indem Funktionsaufrufe auf eine bestimmte Funktion gesucht werden. Es ist wichtig, dass Aufrufe von <code>ast.walk</code> nicht ineinander verschachtelt werden – stattdessen sollten Elemente, über die ein zweites Mal iteriert werden soll, zwischengespeichert werden.

			==Ressourcen==
	Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[Medium:Tracing-Python-Checker-Dummy.zip\|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:		Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[Medium:Tracing-Python-Checker-Dummy.zip\|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:

	* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.		*<code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.
	* <code>testdriver.py</code> enthält vier Testfälle aus dem Beispiel oben und kann beliebig angepasst werden.		*<code>testdriver.py</code> enthält vier Testfälle aus dem Beispiel oben und kann beliebig angepasst werden.
	* <code>studentcode.py</code> enthält eine studentische Einreichung mit einem "Fehler", bei dem einer der Testfälle nicht bestanden wird.		*<code>studentcode.py</code> enthält eine studentische Einreichung mit einem "Fehler", bei dem einer der Testfälle nicht bestanden wird.
	* <code>run.py</code> ist ein Skript, das den Testtreiber ausführt und ausgibt, wie viele Punkte die Lösung ergeben würde.		*<code>run.py</code> ist ein Skript, das den Testtreiber ausführt und ausgibt, wie viele Punkte die Lösung ergeben würde.

	Der Dummy kann mit dem Befehl <code>python run.py</code> ausgeführt werden (auf Linux-Systemen kann der Befehl auch <code>python3</code> lauten, auf Windows auch <code>py</code>).		Der Dummy kann mit dem Befehl <code>python run.py</code> ausgeführt werden (auf Linux-Systemen kann der Befehl auch <code>python3</code> lauten, auf Windows auch <code>py</code>).

LGlaser am 3. Februar 2026 um 07:43 Uhr

2026-02-03T07:43:43Z

← Nächstältere Version		Version vom 3. Februar 2026, 07:43 Uhr
Zeile 79:		Zeile 79:

	== Ressourcen ==		== Ressourcen ==
	Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[~~index.php?title=~~Medium:Tracing-Python-Checker-Dummy.zip\|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:		Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[Medium:Tracing-Python-Checker-Dummy.zip\|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:

	* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.		* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.

LGlaser: Hinweis auf statische Codeanalyse

2026-02-02T16:51:41Z

Hinweis auf statische Codeanalyse

← Nächstältere Version		Version vom 2. Februar 2026, 16:51 Uhr
Zeile 3:		Zeile 3:
	{{Hinweis\|In diesem Artikel werden [https://docs.python.org/3/tutorial/index.html grundlegende Python-Kenntnisse] vorausgesetzt.}}		{{Hinweis\|In diesem Artikel werden [https://docs.python.org/3/tutorial/index.html grundlegende Python-Kenntnisse] vorausgesetzt.}}

	Der Checker arbeitet auf Python 3.11. Aktuell ist es nicht möglich, eigene Module zum Check hinzuzufügen oder Pakete aus dem Python Package Index (PyPI) (über <code>pip</code>) zu laden. Das Paket [https://~~pypi~~.org/~~project~~/~~pandas~~/ pandas] ist vorinstalliert und kann durch den Testtreiber geladen werden, ansonsten sind ausschließlich Pakete der [https://docs.python.org/3.11/library/index.html Python-Standardbibliothek] nutzbar.		Der Checker arbeitet auf Python 3.11. Aktuell ist es nicht möglich, eigene Module zum Check hinzuzufügen oder Pakete aus dem Python Package Index (PyPI) (über <code>pip</code>) zu laden. Das Paket [https://pandas.pydata.org/docs/user_guide/index.html pandas] ist vorinstalliert und kann durch den Testtreiber geladen werden, ansonsten sind ausschließlich Pakete der [https://docs.python.org/3.11/library/index.html Python-Standardbibliothek] nutzbar.

	== Unterstützte Aufgabenstellungen ==		== Unterstützte Aufgabenstellungen ==
Zeile 16:		Zeile 16:
	return a + b		return a + b
	</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.		</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.

			=== Statische Tests & Codeanalyse ===
			Derzeit gibt es für Python keinen statischen (GReQL-)Checker. Der eingereichte Code kann allerdings indirekt auf Syntaxelemente überprüft werden, indem er händisch geparst wird. Hierzu können die Python-Bordmittel, insbesondere das [https://docs.python.org/3.11/library/ast.html AST (Abstract Syntax Trees)]-Modul genutzt werden.

	== Aufbau eines Testtreibers ==		== Aufbau eines Testtreibers ==
	Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)~~#Feedback~~\|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.		Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)\|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.

	Damit die Traces der Testfälle korrekt aufgezeichnet werden, wird jeder Testfall mit dem [https://book.pythontips.com/en/latest/decorators.html Decorator] <code>decorator</code> aus dem vorgegebenen <code>Communicator</code>-Modul gekennzeichnet. Der folgende Code zeigt ein Beispiel mit zwei Testfällen, jeweils ohne Inhalt:<syntaxhighlight lang="python3" line="1">		Damit die Traces der Testfälle korrekt aufgezeichnet werden, wird jeder Testfall mit dem [https://book.pythontips.com/en/latest/decorators.html Decorator] <code>decorator</code> aus dem vorgegebenen <code>Communicator</code>-Modul gekennzeichnet. Der folgende Code zeigt ein Beispiel mit zwei Testfällen, jeweils ohne Inhalt:<syntaxhighlight lang="python3" line="1">
Zeile 76:		Zeile 79:

	== Ressourcen ==		== Ressourcen ==
	Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[~~Media~~:Tracing-Python-Checker-Dummy.zip\|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:		Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[index.php?title=Medium:Tracing-Python-Checker-Dummy.zip\|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:

	* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.		* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.

LGlaser: Doppelter Dateiverweis entfernt

2024-10-24T14:29:57Z

Doppelter Dateiverweis entfernt

← Nächstältere Version		Version vom 24. Oktober 2024, 14:29 Uhr
Zeile 76:		Zeile 76:

	== Ressourcen ==		== Ressourcen ==
	~~[[Datei:Tracing-Python-Checker-Dummy.zip\|mini]]~~
	Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[Media:Tracing-Python-Checker-Dummy.zip\|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:		Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[Media:Tracing-Python-Checker-Dummy.zip\|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:

LGlaser: Link korrigiert

2024-10-24T14:29:15Z

Link korrigiert

← Nächstältere Version		Version vom 24. Oktober 2024, 14:29 Uhr
Zeile 76:		Zeile 76:

	== Ressourcen ==		== Ressourcen ==
	~~Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen~~ [[:Datei:Tracing-Python-Checker-Dummy.zip\|~~Dummy~~]] gebaut, der die Funktion des Checkers simuliert. [~~https~~:~~//wiki.uni-due.de/jack/images/5/57/~~Tracing-Python-Checker-Dummy.zip Den Dummy können Sie hier herunterladen.] Folgende Dateien sind enthalten:		[[Datei:Tracing-Python-Checker-Dummy.zip\|mini]]
			Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [[Media:Tracing-Python-Checker-Dummy.zip\|Den Dummy können Sie hier herunterladen.]] Folgende Dateien sind enthalten:

	* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.		* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.

LGlaser: Links aktualisiert

2024-10-24T14:26:10Z

Links aktualisiert

← Nächstältere Version		Version vom 24. Oktober 2024, 14:26 Uhr
Zeile 76:		Zeile 76:

	== Ressourcen ==		== Ressourcen ==
	Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [https://uni-~~duisburg-essen.sciebo~~.de/s/~~oba5piuG7FcfXcD~~/~~download~~ Den Dummy können Sie hier herunterladen.] Folgende Dateien sind enthalten:		Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen [[:Datei:Tracing-Python-Checker-Dummy.zip\|Dummy]] gebaut, der die Funktion des Checkers simuliert. [https://wiki.uni-due.de/jack/images/5/57/Tracing-Python-Checker-Dummy.zip Den Dummy können Sie hier herunterladen.] Folgende Dateien sind enthalten:

	* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.		* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.

LGlaser: Ressourcen zum Entwickeln des Checkers hinzugefügt

2024-10-24T07:26:21Z

Ressourcen zum Entwickeln des Checkers hinzugefügt

← Nächstältere Version		Version vom 24. Oktober 2024, 07:26 Uhr
Zeile 5:		Zeile 5:
	Der Checker arbeitet auf Python 3.11. Aktuell ist es nicht möglich, eigene Module zum Check hinzuzufügen oder Pakete aus dem Python Package Index (PyPI) (über <code>pip</code>) zu laden. Das Paket [https://pypi.org/project/pandas/ pandas] ist vorinstalliert und kann durch den Testtreiber geladen werden, ansonsten sind ausschließlich Pakete der [https://docs.python.org/3.11/library/index.html Python-Standardbibliothek] nutzbar.		Der Checker arbeitet auf Python 3.11. Aktuell ist es nicht möglich, eigene Module zum Check hinzuzufügen oder Pakete aus dem Python Package Index (PyPI) (über <code>pip</code>) zu laden. Das Paket [https://pypi.org/project/pandas/ pandas] ist vorinstalliert und kann durch den Testtreiber geladen werden, ansonsten sind ausschließlich Pakete der [https://docs.python.org/3.11/library/index.html Python-Standardbibliothek] nutzbar.

	=== Unterstützte Aufgabenstellungen ===		== Unterstützte Aufgabenstellungen ==
	Der dynamische Python-Checker ist darauf ausgelegt, Funktionsaufrufe aufzuzeichnen und ihre Rückgabewerte zu prüfen. Dies funktioniert am besten mit folgenden Aufgabenstellungen:		Der dynamische Python-Checker ist darauf ausgelegt, Funktionsaufrufe aufzuzeichnen und ihre Rückgabewerte zu prüfen. Dies funktioniert am besten mit folgenden Aufgabenstellungen:

Zeile 17:		Zeile 17:
	</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.		</syntaxhighlight>Testfälle (s.u.) können diese Funktion dann mit verschiedenen Werten aufrufen und das Ergebnis prüfen.

	===Aufbau eines Testtreibers===		== Aufbau eines Testtreibers ==
	Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)#Feedback\|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.		Grundsätzlich ist ein Testtreiber ein einzelnes Modul mit einer oder mehreren [https://docs.python.org/3.11/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden. In der Regel importiert der Testtreiber dabei das Modul mit dem eingereichten (zu testenden) Code. Dessen Name [[Python (JACK3)#Feedback\|wird im UI als "Modul-Pfad für studentischen Code"]] festgelegt.

Zeile 74:		Zeile 74:

	Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.		Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.

			== Ressourcen ==
			Um das Entwickeln von Testfällen zu vereinfachen, haben wir einen Dummy gebaut, der die Funktion des Checkers simuliert. [https://uni-duisburg-essen.sciebo.de/s/oba5piuG7FcfXcD/download Den Dummy können Sie hier herunterladen.] Folgende Dateien sind enthalten:

			* <code>Trace.py</code> und <code>Communicator.py</code> simulieren die Funktion des Checkers.
			* <code>testdriver.py</code> enthält vier Testfälle aus dem Beispiel oben und kann beliebig angepasst werden.
			* <code>studentcode.py</code> enthält eine studentische Einreichung mit einem "Fehler", bei dem einer der Testfälle nicht bestanden wird.
			* <code>run.py</code> ist ein Skript, das den Testtreiber ausführt und ausgibt, wie viele Punkte die Lösung ergeben würde.

			Der Dummy kann mit dem Befehl <code>python run.py</code> ausgeführt werden (auf Linux-Systemen kann der Befehl auch <code>python3</code> lauten, auf Windows auch <code>py</code>).
			{{Hinweis\|Der Dummy arbeitet nicht exakt wie der Checker. Es gibt keine Garantie, dass Testtreiber, die mit dem Dummy funktionieren, auch genau so in JACK funktionieren. Testen Sie die Aufgabe deshalb immer auch in JACK!}}
	[[Kategorie:Benutzerhandbuch]]		[[Kategorie:Benutzerhandbuch]]
	[[Kategorie:Checker]]		[[Kategorie:Checker]]

LGlaser: Grammatik

2024-10-21T11:36:46Z

Grammatik

← Nächstältere Version		Version vom 21. Oktober 2024, 11:36 Uhr
Zeile 12:		Zeile 12:
	* Schreiben Sie eine Funktion mit x Parametern, die mit dem ersten Parameter ... macht. (Um die Funktion zu prüfen, muss der Typ des ersten Parameters mutierbar sein, z. B. eine Liste.)		* Schreiben Sie eine Funktion mit x Parametern, die mit dem ersten Parameter ... macht. (Um die Funktion zu prüfen, muss der Typ des ersten Parameters mutierbar sein, z. B. eine Liste.)

	'''Beispiel''': ''Definieren ~~sie~~ eine Funktion add. Die Funktion soll zwei Parameter entgegennehmen und das Ergebnis der Addition zurückgeben.'' Die erwartete Musterlösung für diesen Fall wäre:<syntaxhighlight lang="python3">		'''Beispiel''': ''Definieren Sie eine Funktion add. Die Funktion soll zwei Parameter entgegennehmen und das Ergebnis der Addition zurückgeben.'' Die erwartete Musterlösung für diesen Fall wäre:<syntaxhighlight lang="python3">
	def add(a, b):		def add(a, b):
	return a + b		return a + b

LGlaser: Hinweis auf Tracing konkretisiert

2024-10-09T14:07:03Z

Hinweis auf Tracing konkretisiert

← Nächstältere Version		Version vom 9. Oktober 2024, 14:07 Uhr
Zeile 71:		Zeile 71:
	# Bei Misserfolg: +0 Punkte mit Feedback-Nachricht		# Bei Misserfolg: +0 Punkte mit Feedback-Nachricht
	Trace.printResult(0, f"Erwartete Summe: 1, tatsächlich: {result}.")		Trace.printResult(0, f"Erwartete Summe: 1, tatsächlich: {result}.")
	</syntaxhighlight>Das Tracing reagiert auf alle Arten von Exceptions und zeigt im Falle eines <code>AssertionError</code>s (entweder händisch geworfen oder über <code>assert</code>) eine generische Fehlermeldung an, die mitteilt, dass der Testfall nicht bestanden wurde, sofern kein benutzerdefiniertes Feedback (zweiter Parameter von <code>printResult</code>) vorgegeben wurde.		</syntaxhighlight>Das Tracing reagiert auf alle Arten von Exceptions und zeigt im Falle eines <code>AssertionError</code>s (entweder händisch geworfen oder über <code>assert</code>) eine generische Fehlermeldung an, die mitteilt, dass der Testfall nicht bestanden wurde, sofern kein benutzerdefiniertes Feedback (zweiter Parameter von <code>printResult</code>) vorgegeben wurde. Zusätzlich wird die Variablenbelegung angezeigt und die ausgeführten Zeilen.

	Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.		Pro Testtreiber werden die Punkte aller Testfälle aufsummiert. Bei einer gleichen Gewichtung von vier Testfällen wird jeder Testfall also 25 Punkte im Erfolg zurückmelden. Die summierten Punkte müssen zwischen 0 und 100 (jeweils inklusiv) liegen.
	[[Kategorie:Benutzerhandbuch]]		[[Kategorie:Benutzerhandbuch]]
	[[Kategorie:Checker]]		[[Kategorie:Checker]]

LGlaser: Finalisierung

2024-10-09T14:05:10Z

Finalisierung

@@ Zeile 1: / Zeile 1: @@
-{{Warnung|Warnung=Diese Seite befindet sich noch im Aufbau.}}
+Der [[Python (JACK3)|Aufgabentyp Python]] lässt sich automatisiert bewerten, indem Testfälle ausgeführt werden. Diese können z.&nbsp;B. einen erwarteter Wert mit dem tatsächlichen Wert vergleichen. Der Python-Checker von JACK3 kann nicht nur Punktzahlen und Feedback zurückgeben, sondern auch Traces aufzeichnen (welche Zeilen ausgeführt wurden und wie die Variablenbelegung beim Testfall war). Es lassen sich beliebig komplexe Testfälle und auch zufallsbasierte Tests schreiben sowie passgenaues Feedback, programmiert in Python, erzeugen.
-Der [[Python (JACK3)|Aufgabentyp Python]] lässt sich automatisiert bewerten, indem Testfälle ausgeführt und z.&nbsp;B. ein erwarteter Wert mit einem tatsächlichen Wert verglichen wird. Der Python-Checker von JACK3 kann nicht nur Punktzahlen und Feedback zurückgeben, sondern auch Traces (welche Zeilen ausgeführt wurden und wie die Variablenbelegung beim Testfall war). Hierdurch lassen sich beliebig komplexe Testfälle und auch zufallsbasierte Tests schreiben sowie passgenaues Feedback erzeugen.
+{{Hinweis|In diesem Artikel werden [https://docs.python.org/3/tutorial/index.html grundlegende Python-Kenntnisse] vorausgesetzt.}}
-Der Checker arbeitet auf Python 3. Aktuell ist es nicht möglich, eigene Module zum Check hinzuzufügen oder Pakete aus dem Python Package Index (PyPI) / <code>pip</code> zu laden. Das Paket [https://pypi.org/project/pandas/ pandas] ist vorinstalliert und kann durch den Testtreiber geladen werden, ansonsten sind ausschließlich Pakete der Python-Standardbibliothek eingebunden.
+@Communicator.decorator
-{{Hinweis|In diesem Artikel werden [https://docs.python.org/3/tutorial/index.html grundlegende Python-Kenntnisse] vorausgesetzt.}}
+@Communicator.decorator
-Grundsätzlich ist ein '''Testtreiber''' ein einzelnes Modul mit einem einer oder mehreren [https://docs.python.org/3/tutorial/controlflow.html#defining-functions parameterlosen Funktionen] ('''Testfälle'''), die nacheinander ausgeführt werden.
+if __name__ == '__main__':
-=== API zum Zurückmelden von Ergebnissen ===
+===API zum Zurückmelden von Ergebnissen===
-Testfälle nutzen das Modul <code>Trace</code>, um Ergebnisse zurückzuliefern. Dieses Modul wird während des dynamischen Checks automatisch geladen und sammelt Punktzahlen und Feedback auf. Es bietet folgende Funktionen:<syntaxhighlight lang="python3">
+Innerhalb eines Testfalls werden Ergebnisse über das Modul <code>Trace</code> zurückgeliefert. Dieses Modul sammelt alle Punktzahlen und Feedback auf und berichtet diese am Ende der Ausführung. Es bietet folgende Funktion:<syntaxhighlight lang="python3">
 def printResult(result: int, feedback: str = None):
    """
-   Reports a result at the given line.
+   Reports a result.
    :param result: Points which are reported. Must be between 0 and 100 (both inclusive).
@@ Zeile 19: / Zeile 52: @@
    """
    pass
-</syntaxhighlight>
+</syntaxhighlight>{{Wichtig|In jedem Testfall muss <code>printResult</code> genau ein Mal tatsächlich aufgerufen werden!}}
 [[Kategorie:Benutzerhandbuch]]
-__KEIN_INHALTSVERZEICHNIS__
+[[Kategorie:Checker]]