CKTIS / Python
Anotación de tipo con referencia adelantada
En Python 3.12, una anotación de tipo entre comillas puede referirse a un nombre que solo está disponible después de definir la función.
Versión: Python 3.12
Sintaxis
def run_test(test: "Callable[[], None]") -> None:
test()En Python 3.12, sin from __future__ import annotations, las anotaciones de una función se evalúan al ejecutar la sentencia def, no al llamar a la función. Un nombre sin comillas que aún no está disponible puede provocar NameError en ese momento. Una anotación con referencia adelantada puede escribirse como una cadena, por ejemplo "Callable[[], None]", para resolver la expresión de tipo más adelante.
En la firma de run_test, Callable[[], None] describe un objeto invocable que no acepta argumentos ([]) y devuelve None. El -> None separado indica qué devuelve la propia función run_test. Las comillas no indican que haya que pasar una cadena, y Python no comprueba automáticamente que el argumento se ajuste a la anotación.
run_test.__annotations__["test"] contiene la cadena. typing.get_type_hints(run_test) evalúa la expresión en el espacio de nombres adecuado y puede lanzar NameError si Callable sigue sin estar disponible. Si Callable ya está disponible cuando se ejecuta def, las comillas sobran. No resuelvas anotaciones de fuentes no fiables: evaluar las expresiones que contienen puede ejecutar código.
Ejemplos
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
La importación desde `collections.abc` aparece deliberadamente después de definir `run_test`. La primera línea muestra la representación de la cadena, `True` confirma que el tipo resuelto coincide con el esperado y `Test ran` lo imprime la función de prueba invocada.
Lecciones relacionadas
- Python · Lección 26 · Básico · Versión: 3