Python · Intermediário · Inglês · Técnico
type hints
Anotações de tipo opcionais em parâmetros, retornos e variáveis, como def f(x: int) -> str. O Python não as impõe na execução; servem a editores e verificadores como mypy.
Onde usar
Em code review, os hints deixam claro o contrato de funções públicas e melhoram o autocompletar. Em projetos grandes, o CI roda mypy ou pyright para pegar erros antes de executar.
Em código
def saudar(nome: str, n: int = 1) -> str:
return ('oi ' + nome + ' ') * n
x: list[int] = [1, 2]Exemplos
Add type hints to the public functions.
Adicione type hints nas funções públicas.
The type hints say it returns a list, but it can return None.
Os type hints dizem que retorna uma lista, mas pode retornar None.
Cuidado
Não espere que o interpretador rejeite um argumento do tipo errado; sem verificador ou biblioteca de validação, a anotação é ignorada.
Sinônimos
anotações de tipo, tipagem gradual