Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes