CKTIS / Python
Annotations mit Zeichenketten für Vorwärtsreferenzen
Eine Annotation wie "Node" bezeichnet einen Typ anhand eines als Text gespeicherten Namens, auch wenn die Klasse erst später definiert wird. Python 3.14 wertet Annotationen standardmäßig verzögert aus; Anführungszeichen sind daher oft nicht mehr nötig, bleiben aber gültige Syntax.
Version: Python 3.14; repository image, production runtime not attested
Syntax
def f(value: "LaterType") -> "LaterType": ...Annotations mit Zeichenketten für Vorwärtsreferenzen (quoted forward-reference annotations) verwenden ein Stringliteral als Typhinweis, etwa node: "Node" oder -> "Node". Damit kann auf eine später definierte Klasse verwiesen werden, auch auf eine Klasse, die sich selbst referenziert. Das bedeutet nicht, dass der erwartete Wert den Typ str hat.
In Python 3.14 wird die Auswertung von Annotationen standardmäßig verzögert, sodass für diese Art von Referenz normalerweise auch ein nicht in Anführungszeichen gesetztes Node genügt. Explizites "Node" bleibt gültig. Das ist etwas anderes als from __future__ import annotations, wodurch Annotationen als Zeichenketten gespeichert werden. Typhinweise allein erzwingen zur Laufzeit keine Argumenttypen.
typing.get_type_hints() löst Zeichenkettenreferenzen in tatsächliche Typen auf. Rufe die Funktion erst auf, wenn die benötigten Namen in den entsprechenden Namensräumen verfügbar sind; ein nicht auflösbarer Name kann einen NameError verursachen. Die Funktion kann in Annotationen enthaltenen Code ausführen. Verwende sie daher nicht mit nicht vertrauenswürdigen Annotationen.
Im Beispiel steht identity vor der Definition von Node, die Typhinweise werden aber erst danach untersucht. Die beiden Ergebnisse True zeigen, dass beide Annotationen wie erwartet zur Klasse Node aufgelöst werden. Die letzte Zeile zeigt den Klassennamen des zurückgegebenen Objekts.
Beispiele
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__)
Ergebnis
True True Node
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.