CKTIS / Python
Анотации на препратки напред в кавички
Анотация като "Node" описва тип чрез име, съхранено като текст, дори когато класът е дефиниран по-късно. Python 3.14 отлага оценяването на анотациите по подразбиране, затова кавичките често вече не са необходими, но остават валиден синтаксис.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
def f(value: "LaterType") -> "LaterType": ...Анотациите на препратки напред в кавички (quoted forward-reference annotations) използват низов литерал като указание за тип, например node: "Node" или -> "Node". Те позволяват препращане към клас, дефиниран по-късно, включително към клас, който препраща към себе си. Това не означава, че очакваната стойност е от тип str.
В Python 3.14 оценяването на анотациите се отлага по подразбиране, така че за този вид препратка обикновено е достатъчно и Node без кавички. Изричният запис "Node" остава валиден. Това е различно от from __future__ import annotations, което кара анотациите да се съхраняват като низове. Самите указания за тип не налагат типовете на аргументите по време на изпълнение.
typing.get_type_hints() разрешава текстовите препратки до действителни типове. Извикайте я само когато необходимите имена са налични в съответните пространства от имена; неразрешено име може да доведе до NameError. Функцията може да изпълнява код, съдържащ се в анотациите, затова не я използвайте с анотации, на които нямате доверие.
В примера identity се появява преди дефиницията на Node, но указанията за тип се разглеждат след нея. Двата резултата True показват очакваното разрешаване на двете анотации до класа Node, а последният ред показва името на класа на върнатия обект.
Примери
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__)
Резултат
True True Node
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.