CKTIS / Python
Annotations de références anticipées entre guillemets
Une annotation comme "Node" désigne un type à l’aide d’un nom stocké sous forme de texte, même si la classe est définie plus tard. Python 3.14 diffère l’évaluation des annotations par défaut : les guillemets ne sont donc souvent plus nécessaires, mais restent une syntaxe valide.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
def f(value: "LaterType") -> "LaterType": ...Les annotations de références anticipées entre guillemets (quoted forward-reference annotations) utilisent un littéral chaîne comme indication de type, par exemple node: "Node" ou -> "Node". Elles permettent de faire référence à une classe définie plus tard, y compris à une classe qui se référence elle-même. Cela ne signifie pas que la valeur attendue est de type str.
Dans Python 3.14, l’évaluation des annotations est différée par défaut ; pour ce type de référence, Node sans guillemets suffit donc généralement aussi. La forme explicite "Node" reste valide. Cela diffère de from __future__ import annotations, qui entraîne le stockage des annotations sous forme de chaînes. Les indications de type, à elles seules, n’imposent pas les types des arguments à l’exécution.
typing.get_type_hints() résout les références textuelles en types réels. Appelez cette fonction uniquement lorsque les noms nécessaires sont disponibles dans les espaces de noms appropriés ; un nom non résolu peut provoquer une NameError. La fonction peut exécuter du code contenu dans les annotations : ne l’utilisez donc pas avec des annotations non fiables.
Dans l’exemple, identity apparaît avant la définition de Node, mais les indications de type sont examinées après celle-ci. Les deux résultats True montrent que les deux annotations sont résolues comme prévu en la classe Node, et la dernière ligne affiche le nom de classe de l’objet renvoyé.
Exemples
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__)
Résultat
True True Node
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.