Anotações de tipo em Python
Exemplos compatíveis com Python 3.13 ou superior.
O interpretador não usa as anotações para impor os tipos de argumentos e variáveis. Elas servem principalmente a ferramentas de análise estática, editores e leitores do código:
- Permitir que ferramentas como
mypye Pyright encontrem incompatibilidades antes da execução. - Melhorar o preenchimento automático e a documentação exibida pelos editores.
- Registrar as expectativas da interface do código.
- Detectar erros simples, como passar um
intquando a função espera umastr.
Tipos básicos
name: str = "Lucas Borges"
x: int = 10
y: float = 20.5
is_valid: bool = False
data: bytes = b"weather"
Constantes
Python não impede a reatribuição de uma variável apenas porque seu nome está em letras maiúsculas; essa escrita é uma convenção. Quando a anotação explícita não acrescenta informação, podemos deixar que a ferramenta infira o tipo:
Coleções
Geralmente, são tipos que contêm mais de um valor, como listas, tuplas e dicionários:
list_nums: list[int] = [1, 2, 3]
tuple_two_values: tuple[str, int] = ("value", 123)
tuple_many_values: tuple[str, ...] = "a", "b", "c", "d", "..."
any_set: set[int] = {1, 2, 3, 4}
frozen_set: frozenset[int] = frozenset([5, 6, 7])
any_dict: dict[str, str] = {"key1": "value1", "key2": "value2"}
any_range: range = range(5)
Outros tipos
Constantes com Final
Final informa aos verificadores de tipo que o nome não deve ser reatribuído. Essa restrição não é aplicada durante a execução:
Final impede apenas a reatribuição do nome para o verificador estático; ele não torna imutável uma coleção mutável. Nesse exemplo, ainda é possível alterar o conteúdo da lista durante a execução.