CKTIS / Python
typing.TypedDict
Describe un esquema de diccionario con claves de texto conocidas y un tipo de valor por campo.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
class Task(TypedDict): ...Describe un esquema de diccionario con claves de texto conocidas y un tipo de valor por campo.
Por defecto las claves sin NotRequired son obligatorias. El constructor devuelve un dict normal sin validación e isinstance con la clase TypedDict provoca TypeError. Desde Python 3.13 ReadOnly indica un campo que el comprobador prohíbe modificar independientemente de que sea obligatorio.
El diccionario permite escribir en ejecución.
Ejemplos
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}El diccionario permite escribir en ejecución.