WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

typing.TypedDict

Beschreibt ein Wörterbuchschema mit bekannten Zeichenkettenschlüsseln und einem Werttyp pro Feld.

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

Syntax

class Task(TypedDict): ...

Beschreibt ein Wörterbuchschema mit bekannten Zeichenkettenschlüsseln und einem Werttyp pro Feld.

Standardmäßig sind Schlüssel ohne NotRequired erforderlich. Der Konstruktor liefert ein gewöhnliches dict ohne Prüfung und isinstance mit der TypedDict-Klasse löst TypeError aus. Seit Python 3.13 kennzeichnet ReadOnly ein statisch nicht änderbares Feld, unabhängig von seiner Pflicht zur Anwesenheit.

Das Wörterbuch erlaubt die Änderung zur Laufzeit.

Beispiele

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)

Ergebnis

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

Das Wörterbuch erlaubt die Änderung zur Laufzeit.

Quellen