CKTIS / Python
typing.TypedDict
Описва схема на речник с известни низови ключове и отделен тип на стойността за всяко поле.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
class Task(TypedDict): ...Описва схема на речник с известни низови ключове и отделен тип на стойността за всяко поле.
По подразбиране ключовете без NotRequired са задължителни. Конструкторът връща обикновен dict без проверка, а isinstance с клас TypedDict предизвиква TypeError. От Python 3.13 ReadOnly означава поле, което статичната проверка забранява да се променя независимо дали е задължително.
При изпълнение речникът позволява запис.
Примери
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)
Резултат
True {'x': 'other'} ['x', 'y']
no instance check
{'id': 2}При изпълнение речникът позволява запис.