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