CKTIS / Python
Anotaciones de referencias adelantadas entre comillas
Una anotación como "Node" describe un tipo mediante un nombre almacenado como texto, aunque la clase se defina más adelante. Python 3.14 aplaza la evaluación de las anotaciones de forma predeterminada, así que las comillas ya no suelen ser necesarias, pero siguen siendo sintaxis válida.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
def f(value: "LaterType") -> "LaterType": ...Las anotaciones de referencias adelantadas entre comillas (quoted forward-reference annotations) usan un literal de cadena como indicación de tipo, por ejemplo, node: "Node" o -> "Node". Permiten hacer referencia a una clase definida más adelante, incluso a una clase que se hace referencia a sí misma. No significan que el valor esperado sea de tipo str.
En Python 3.14, la evaluación de las anotaciones se aplaza de forma predeterminada, por lo que normalmente también basta con Node sin comillas para este tipo de referencia. La forma explícita "Node" sigue siendo válida. Esto no es lo mismo que from __future__ import annotations, que hace que las anotaciones se almacenen como cadenas. Las indicaciones de tipo por sí solas no imponen los tipos de los argumentos durante la ejecución.
typing.get_type_hints() resuelve las referencias de texto y las convierte en tipos reales. Llámala solo cuando los nombres necesarios estén disponibles en los espacios de nombres correspondientes; un nombre sin resolver puede provocar un NameError. La función puede ejecutar código incluido en las anotaciones, así que no la uses con anotaciones que no sean de confianza.
En el ejemplo, identity aparece antes de la definición de Node, pero las indicaciones se consultan después. Los dos resultados True muestran la resolución esperada de ambas anotaciones a la clase Node, y la última línea muestra el nombre de la clase del objeto devuelto.
Ejemplos
from typing import get_type_hints
def identity(node: "Node") -> "Node":
return node
class Node:
pass
hints = get_type_hints(identity)
print(hints["node"] is Node)
print(hints["return"] is Node)
print(identity(Node()).__class__.__name__)
Resultado
True True Node
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.