O que é a anotação de tipo Optional em Python?

Optional[T] em Python é uma abreviação de Union[T, None]. Indica que uma variável, parâmetro de função ou valor de retorno pode ser do tipo T ou None. É usado para indicar de forma mais explícita a possibilidade de ausência de valor.

Exemplo de uso:

# Anotação do parâmetro de função
def process_data(data: Optional[str]) -> Optional[int]:
    if data is None:
        return None
    # Lógica de processamento de dados
    try:
        return int(data)
    except ValueError:
        return None

# Anotação de variável
user_id: Optional[int] = get_user_id()

Aplicação	Descrição
Anotação de parâmetros de funções	Indica que o argumento pode ser omitido ou igual a None.
Anotação de valores de retorno	Demonstra que a função pode retornar um valor ou None.
Anotação de variáveis	Mostra que a variável pode conter um valor do tipo especificado ou None.

O uso de Optional melhora a legibilidade do código e ajuda as ferramentas de análise estática (por exemplo, MyPy) a identificar erros potenciais relacionados ao tratamento de None.