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

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.

Fuentes