Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes