CKTIS / Python
typing.TypedDict
Descreve um esquema de dicionário com chaves de texto conhecidas e um tipo de valor por campo.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
class Task(TypedDict): ...Descreve um esquema de dicionário com chaves de texto conhecidas e um tipo de valor por campo.
Por predefinição as chaves sem NotRequired são obrigatórias. O construtor devolve um dict normal sem validação e isinstance com a classe TypedDict lança TypeError. Desde Python 3.13 ReadOnly indica um campo que o verificador proíbe alterar, independentemente de ser obrigatório.
O dicionário permite a escrita em execução.
Exemplos
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)
Resultado
True {'x': 'other'} ['x', 'y']
no instance check
{'id': 2}O dicionário permite a escrita em execução.