Python · Avançado · Inglês · Técnico
Annotated
Construção do módulo typing, Annotated[T, metadado], que anexa informação extra a um tipo sem alterá-lo para o verificador. Bibliotecas leem esses metadados em execução.
Onde usar
Muito usado em FastAPI e Pydantic para declarar validações e a origem de parâmetros ao lado do tipo. Em code review, ajuda a reutilizar tipos validados como alias.
Em código
from typing import Annotated
Idade = Annotated[int, 'anos']
x: Idade = 30
print(Idade.__metadata__) # ('anos',)Exemplos
We use Annotated to attach the validation rule to the type.
Usamos Annotated para anexar a regra de validação ao tipo.
Annotated metadata is ignored unless a library reads it.
O metadado do Annotated é ignorado se nenhuma biblioteca o ler.
Cuidado
O Python não valida nada sozinho: os metadados só têm efeito se alguma biblioteca os lê.