Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

typing.TypedDict

Descrive lo schema di un dizionario con chiavi testuali note e un tipo di valore per ciascun campo.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

class Task(TypedDict): ...

Descrive lo schema di un dizionario con chiavi testuali note e un tipo di valore per ciascun campo.

Per impostazione predefinita le chiavi senza NotRequired sono obbligatorie. Il costruttore restituisce un normale dict senza controlli e isinstance con la classe TypedDict solleva TypeError. Da Python 3.13 ReadOnly indica un campo che il verificatore vieta di modificare indipendentemente dall’obbligo di presenza.

Il dizionario consente la scrittura in esecuzione.

Esempi

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)

Risultato

True {'x': 'other'} ['x', 'y']
no instance check
{'id': 2}

Il dizionario consente la scrittura in esecuzione.

Fonti