CKTIS / Python
typing.NotRequired
Permite omitir uma chave específica de TypedDict mesmo quando as restantes são obrigatórias por predefinição.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
note: NotRequired[str]Permite omitir uma chave específica de TypedDict mesmo quando as restantes são obrigatórias por predefinição.
Omitir um campo de texto é diferente de lhe atribuir None.
Os metadados __optional_keys__ enumeram a chave mas a leitura direta quando falta lança KeyError.
Exemplos
from typing import NotRequired, TypedDict
class Job(TypedDict):
key: int
note: NotRequired[str]
job: Job = {"key": 2}
print(sorted(Job.__optional_keys__), "note" in job)
try:
print(job["note"])
except KeyError:
print("absent")
Resultado
['note'] False absent
Os metadados `__optional_keys__` enumeram a chave mas a leitura direta quando falta lança KeyError.