Gestructureerde uitvoer · oefening
Schrijf een pydantic-model
QuizQuestion beschrijft één vraag. Een antwoord bevat een hele quiz: een object met een lijst questions, zoals QUIZ_SYSTEM vraagt. Deze les schrijft het model voor dat object, QuizSet, in dezelfde vorm die je in les 4 hebt gelezen.
Schrijf QuizSet
In quiz_models.py, onder QuizQuestion, staat de plaatshouder:
# Lesson 5: replace the next line with your QuizSet model.
QuizSet = None
Vervang beide regels door een model. Neem de klasseregel over van QuizQuestion, verander de naam en geef het één veld, questions, met als hint een lijst van QuizQuestion:
class QuizSet(BaseModel):
questions: list[QuizQuestion]
list[QuizQuestion] gebruikt het ene model in het andere: een QuizSet bevat een lijst, en elk item van die lijst is een QuizQuestion. Zet QuizSet na QuizQuestion, zodat een lezer QuizQuestion tegenkomt voor het model dat het gebruikt. In Python-versies vóór 3.14 is die volgorde verplicht: de hint wordt geëvalueerd als de klasseregel draait, en QuizQuestion moet dan al bestaan.
Geef het veld geen standaardwaarde. Zonder standaardwaarde is het veld verplicht, dus een antwoord zonder questions is geen geldige quiz.
Geneste dictionaries worden modellen
Hier is het hele bestand zoals het eruit komt te zien, gevolgd door een quiz die uit gewone dictionaries is gebouwd:
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}
Je gaf dictionaries mee, en QuizSet maakte van elk een QuizQuestion, omdat de hint van het veld zegt dat de items dat zijn. Daardoor lees je quiz.questions[1].choices helemaal met punten. type(...).__name__ drukt de naam van het type van een waarde af, hier QuizQuestion, niet dict.
Kijk naar de tweede dictionary: die heeft een sleutel die het model niet declareert, "hint". Standaard negeert pydantic sleutels die het niet kent, dus model_dump() toont alleen de drie velden. Een antwoord van het taalmodel kan extra sleutels bevatten, en je programma ziet ze nooit.
Als één item geen QuizQuestion kan worden, bijvoorbeeld omdat de answer_index gelijk is aan "first", mislukt het maken van de QuizSet met een fout die het probleem noemt. Die fout is het onderwerp van les 6.
Voer het uit
Voer python structured.py uit. De demonstratie bouwt een QuizSet uit twee dictionaries, drukt die af, en drukt het type van de tweede vraag af:
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 is de vorm waar het hele hoofdstuk om draait. Het antwoord dat het taalmodel stuurt is JSON-tekst, en les 6 maakt van die tekst in één stap een QuizSet, of vertelt je precies waarom dat niet lukt.
QuizSet heeft het veld questions: list[QuizQuestion]. Je maakt QuizSet(questions=[{"question": "Q?", "choices": ["a", "b"], "answer_index": 0}]). Wat is quiz.questions[0]?
Een vraag in een antwoord heeft een extra sleutel, "difficulty": "easy", die QuizQuestion niet declareert. Wat doet pydantic er standaard mee?
Opdracht
Vervang in quiz_models.py de regel QuizSet = None door een pydantic-model met de naam QuizSet:
schrijf de klasseregel zoals die van
QuizQuestion, met(BaseModel);geef het precies één veld,
questions, met als hint een lijst vanQuizQuestion.
Laat QuizQuestion zoals het is, en geef het veld geen standaardwaarde. Voer python structured.py uit om een QuizSet te zien die uit dictionaries is gebouwd, en controleer daarna je werk.