База знанияИзпитен център
BGБългарски
Избери език13

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}

При изпълнение речникът позволява запис.

Източници