CKTIS / Python
Adnotacje odwołań w przód zapisane w cudzysłowie
Adnotacja taka jak "Node" opisuje typ przez nazwę zapisaną jako tekst, nawet gdy klasa zostanie zdefiniowana później. Python 3.14 domyślnie odracza obliczanie adnotacji, więc cudzysłowy często nie są już potrzebne, ale pozostają poprawnym zapisem.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
def f(value: "LaterType") -> "LaterType": ...Adnotacje odwołań w przód zapisane w cudzysłowie (quoted forward-reference annotations) używają literału tekstowego jako wskazówki typu, np. node: "Node" lub -> "Node". Pozwalają wskazać klasę zdefiniowaną później, w tym klasę odwołującą się do siebie. Nie oznaczają, że oczekiwana wartość ma typ str.
W Python 3.14 obliczanie adnotacji jest domyślnie odroczone, więc przy takim odwołaniu zwykle wystarczy też niecytowane Node. Jawne "Node" pozostaje poprawne. To nie jest to samo co from __future__ import annotations, które powoduje przechowywanie adnotacji jako tekstu. Same wskazówki typu nie wymuszają typów argumentów podczas wykonania.
typing.get_type_hints() rozwiązuje tekstowe odwołania do rzeczywistych typów. Wywołaj je dopiero wtedy, gdy potrzebne nazwy są dostępne w odpowiednich przestrzeniach nazw; nierozwiązana nazwa może spowodować NameError. Funkcja może wykonywać kod zawarty w adnotacjach, więc nie używaj jej do niezaufanych adnotacji.
W przykładzie identity występuje przed definicją Node, ale odczyt wskazówek następuje po niej. Dwa wyniki True pokazują oczekiwane rozwiązanie obu adnotacji do klasy Node, a ostatni wiersz pokazuje nazwę klasy zwróconego obiektu.
Przykłady
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__)
Wynik
True True Node
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.