0%

Strukturierte Ausgabe · Übung

Ein Pydantic-Modell schreiben

QuizQuestion beschreibt eine Frage. Eine Antwort enthält ein ganzes Quiz: ein Objekt mit einer Liste questions, wie QUIZ_SYSTEM verlangt. In dieser Lektion schreibst du das Modell für dieses Objekt, QuizSet, in derselben Form, die du in Lektion 4 gelesen hast.

Schreibe QuizSet

In quiz_models.py steht unter QuizQuestion der Platzhalter:

# Lesson 5: replace the next line with your QuizSet model.
QuizSet = None

Ersetze beide Zeilen durch ein Modell. Kopiere die Klassenzeile von QuizQuestion, ändere den Namen und gib dem Modell ein Feld, questions, dessen Hint eine Liste von QuizQuestion ist:

class QuizSet(BaseModel):
    questions: list[QuizQuestion]

list[QuizQuestion] verwendet ein Modell in einem anderen: Ein QuizSet enthält eine Liste, und jedes Element dieser Liste ist eine QuizQuestion. Setze QuizSet hinter QuizQuestion, damit ein Leser QuizQuestion vor dem Modell kennenlernt, das es verwendet. In Python-Versionen vor 3.14 ist diese Reihenfolge Pflicht: Der Hint wird ausgewertet, wenn die Klassenzeile läuft, und QuizQuestion muss dann schon existieren.

Gib dem Feld keinen Standardwert. Ohne Standardwert ist das Feld Pflicht, eine Antwort ganz ohne questions ist also kein gültiges Quiz.

Verschachtelte Dictionaries werden zu Modellen

Hier ist die ganze Datei, wie sie aussehen wird, gefolgt von einem Quiz, das aus einfachen Dictionaries gebaut wird:

from pydantic import BaseModel


class QuizQuestion(BaseModel):
    question: str
    choices: list[str]
    answer_index: int


class QuizSet(BaseModel):
    questions: list[QuizQuestion]


quiz = QuizSet(
    questions=[
        {"question": "What does len([]) return?", "choices": ["0", "None"], "answer_index": 0},
        {"question": "Which brackets make a list?", "choices": ["()", "[]", "{}"], "answer_index": 1, "hint": "square"},
    ]
)
print(type(quiz.questions[1]).__name__)
print(quiz.questions[1].choices)
print(quiz.questions[1].model_dump())
QuizQuestion
['()', '[]', '{}']
{'question': 'Which brackets make a list?', 'choices': ['()', '[]', '{}'], 'answer_index': 1}

Du hast Dictionaries übergeben, und QuizSet hat jedes davon in eine QuizQuestion umgewandelt, weil der Hint des Feldes sagt, dass die Elemente genau das sind. Deshalb liest sich quiz.questions[1].choices durchgehend mit Punkten. type(...).__name__ gibt den Namen des Typs eines Werts aus, hier QuizQuestion, nicht dict.

Sieh dir das zweite Dictionary an: Es hat einen Schlüssel, den das Modell nicht deklariert, "hint". Standardmäßig ignoriert Pydantic Schlüssel, die es nicht kennt, deshalb zeigt model_dump() nur die drei Felder. Eine Antwort des Sprachmodells kann zusätzliche Schlüssel enthalten, und dein Programm bekommt sie nie zu sehen.

Wenn ein Element keine QuizQuestion werden kann, zum Beispiel weil sein answer_index "first" ist, scheitert das Erstellen des QuizSet mit einem Fehler, der das Problem benennt. Um diesen Fehler geht es in Lektion 6.

Ausführen

Führe python structured.py aus. Die Demonstration baut ein QuizSet aus zwei Dictionaries, gibt es aus und gibt den Typ seiner zweiten Frage aus:

A QuizSet built from dictionaries:
  QuizSet(questions=[QuizQuestion(question='What does len([]) return?', choices=['0', 'None'], answer_index=0), QuizQuestion(question='Which brackets make a list?', choices=['()', '[]', '{}'], answer_index=1)])
  quiz.questions[1] is a QuizQuestion
The JSON reply, validated by parse_quiz:
Run stopped at the next function to build: parse_quiz is built in Lesson 6.

QuizSet ist die Form, um die es im ganzen Kapitel geht. Die Antwort, die das Sprachmodell sendet, ist JSON-Text, und Lektion 6 macht aus diesem Text in einem Schritt ein QuizSet oder sagt dir genau, warum das nicht geht.

QuizSet hat das Feld questions: list[QuizQuestion]. Du erstellst QuizSet(questions=[{"question": "Q?", "choices": ["a", "b"], "answer_index": 0}]). Was ist quiz.questions[0]?

Eine Frage in einer Antwort hat einen zusätzlichen Schlüssel, "difficulty": "easy", den QuizQuestion nicht deklariert. Was macht Pydantic standardmäßig damit?

Aufgabe

Ersetze in quiz_models.py die Zeile QuizSet = None durch ein Pydantic-Modell namens QuizSet:

  • schreibe seine Klassenzeile so wie die von QuizQuestion, mit (BaseModel);

  • gib ihm genau ein Feld, questions, dessen Hint eine Liste von QuizQuestion ist.

Lass QuizQuestion unverändert und gib dem Feld keinen Standardwert. Führe python structured.py aus, um ein aus Dictionaries gebautes QuizSet zu sehen, und prüfe dann deine Arbeit.