Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes