Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

Anotação de tipo com referência antecipada

Em Python 3.12, uma anotação de tipo entre aspas pode referir-se a um nome que só fica disponível depois de a função ser definida.

Versão: Python 3.12

Sintaxe

def run_test(test: "Callable[[], None]") -> None:
    test()

Em Python 3.12, sem from __future__ import annotations, as anotações de uma função são avaliadas quando se executa a instrução def, não quando se chama a função. Um nome sem aspas que ainda não esteja disponível pode causar NameError nesse momento. Uma anotação com referência antecipada pode ser escrita como uma cadeia de caracteres, por exemplo "Callable[[], None]", para que a expressão de tipo seja resolvida mais tarde.

Na assinatura de run_test, Callable[[], None] descreve um objeto chamável que não aceita argumentos ([]) e devolve None. O -> None separado indica o que a própria função run_test devolve. As aspas não significam que se deva passar uma cadeia de caracteres, e o Python não verifica automaticamente se o argumento corresponde à anotação.

run_test.__annotations__["test"] contém a cadeia de caracteres. typing.get_type_hints(run_test) avalia a expressão no espaço de nomes adequado e pode lançar NameError se Callable continuar indisponível. Se Callable já estiver disponível quando se executa def, as aspas são desnecessárias. Não resolvas anotações de fontes não fiáveis: avaliar as expressões que contêm pode executar código.

Exemplos

from typing import get_type_hints


def run_test(test: "Callable[[], None]") -> None:
    test()


from collections.abc import Callable  # Deliberately imported after run_test.


def smoke_test() -> None:
    print("Test ran", end="")


print(repr(run_test.__annotations__["test"]))
print(get_type_hints(run_test)["test"] == Callable[[], None])
run_test(smoke_test)

Resultado

'Callable[[], None]'
True
Test ran

A importação a partir de `collections.abc` surge propositadamente após a definição de `run_test`. A primeira linha mostra a representação da cadeia de caracteres, `True` confirma que o tipo resolvido coincide com o esperado, e `Test ran` é escrito pela função de teste chamada.

Lições relacionadas

  • Python · Lição 26 · Básico · Versão: 3

Fontes