KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

typing.TypedDict

Beschrijft een woordenboekschema met bekende tekenreekssleutels en een afzonderlijk waardetype per veld.

Versie: Python 3.14; repository image, production runtime not attested

Syntax

class Task(TypedDict): ...

Beschrijft een woordenboekschema met bekende tekenreekssleutels en een afzonderlijk waardetype per veld.

Standaard zijn sleutels zonder NotRequired verplicht. De constructor geeft zonder validatie een gewone dict terug en isinstance met de TypedDict-klasse geeft TypeError. Sinds Python 3.13 markeert ReadOnly een statisch onwijzigbaar veld, los van verplichte aanwezigheid.

Het woordenboek staat schrijven tijdens uitvoering toe.

Voorbeelden

from typing import TypedDict
class Point(TypedDict):
    x: int
    y: int
point = Point(x="other")
print(type(point) is dict, point, sorted(Point.__required_keys__))
try:
    isinstance(point, Point)
except TypeError:
    print("no instance check")
from typing import NotRequired, ReadOnly
class Label(TypedDict):
    id: ReadOnly[int]
    note: ReadOnly[NotRequired[str]]
label: Label = {"id": 1}
label["id"] = 2
assert Label.__readonly_keys__ == {"id", "note"}
assert Label.__required_keys__ == {"id"} and Label.__optional_keys__ == {"note"}
print(label)

Resultaat

True {'x': 'other'} ['x', 'y']
no instance check
{'id': 2}

Het woordenboek staat schrijven tijdens uitvoering toe.

Bronnen