CKTIS / Python
Geannoteerde voorwaartse verwijzingen tussen aanhalingstekens
Een annotatie zoals "Node" beschrijft een type met een naam die als tekst is opgeslagen, ook als de klasse later wordt gedefinieerd. Python 3.14 stelt de evaluatie van annotaties standaard uit. Aanhalingstekens zijn daarom vaak niet meer nodig, maar blijven geldige syntaxis.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
def f(value: "LaterType") -> "LaterType": ...Geannoteerde voorwaartse verwijzingen tussen aanhalingstekens (quoted forward-reference annotations) gebruiken een stringliteral als typehint, zoals node: "Node" of -> "Node". Zo kan worden verwezen naar een klasse die later wordt gedefinieerd, ook naar een klasse die naar zichzelf verwijst. Dit betekent niet dat de verwachte waarde het type str heeft.
In Python 3.14 wordt de evaluatie van annotaties standaard uitgesteld, waardoor voor dit soort verwijzingen meestal ook Node zonder aanhalingstekens volstaat. De expliciete vorm "Node" blijft geldig. Dit is iets anders dan from __future__ import annotations, waardoor annotaties als strings worden opgeslagen. Typehints dwingen op zichzelf tijdens runtime geen argumenttypen af.
typing.get_type_hints() zet tekstuele verwijzingen om in echte typen. Roep deze functie alleen aan wanneer de benodigde namen beschikbaar zijn in de juiste naamruimten; een niet opgeloste naam kan een NameError veroorzaken. De functie kan code uitvoeren die in annotaties staat, dus gebruik haar niet met niet-vertrouwde annotaties.
In het voorbeeld staat identity vóór de definitie van Node, maar worden de typehints pas daarna bekeken. De twee resultaten True laten zien dat beide annotaties zoals verwacht worden opgelost naar de klasse Node. De laatste regel toont de klassenaam van het teruggegeven object.
Voorbeelden
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__)
Resultaat
True True Node
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.