CKTIS / Python
Anotace dopředných odkazů v uvozovkách
Anotace jako "Node" popisuje typ pomocí názvu uloženého jako text, i když je třída definována až později. Python 3.14 ve výchozím nastavení odkládá vyhodnocení anotací, takže uvozovky často už nejsou potřeba, ale zůstávají platným zápisem.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
def f(value: "LaterType") -> "LaterType": ...Anotace dopředných odkazů v uvozovkách (quoted forward-reference annotations) používají řetězcový literál jako typovou nápovědu, například node: "Node" nebo -> "Node". Umožňují odkazovat na třídu definovanou později, včetně třídy, která odkazuje sama na sebe. Neznamenají, že očekávaná hodnota má typ str.
V Pythonu 3.14 se vyhodnocení anotací ve výchozím nastavení odkládá, takže pro tento druh odkazu obvykle stačí i Node bez uvozovek. Výslovný zápis "Node" zůstává platný. To se liší od from __future__ import annotations, které způsobí ukládání anotací jako řetězců. Samotné typové nápovědy za běhu nevynucují typy argumentů.
typing.get_type_hints() převádí textové odkazy na skutečné typy. Zavolejte ji až ve chvíli, kdy jsou potřebné názvy dostupné v příslušných jmenných prostorech; nevyřešený název může způsobit NameError. Funkce může spouštět kód obsažený v anotacích, proto ji nepoužívejte u nedůvěryhodných anotací.
V příkladu se identity objevuje před definicí Node, ale typové nápovědy se zkoumají až poté. Dva výsledky True ukazují očekávané vyřešení obou anotací na třídu Node a poslední řádek uvádí název třídy vráceného objektu.
Příklady
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__)
Výsledek
True True Node
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.