CKTIS / Python
Anotacije referenci unaprijed u navodnicima
Anotacija poput "Node" opisuje tip pomoću naziva pohranjenog kao tekst, čak i kada se klasa definira kasnije. Python 3.14 prema zadanim postavkama odgađa evaluaciju anotacija, pa navodnici često više nisu potrebni, ali ostaju valjana sintaksa.
Verzija: Python 3.14; repository image, production runtime not attested
Sintaksa
def f(value: "LaterType") -> "LaterType": ...Anotacije referenci unaprijed u navodnicima (quoted forward-reference annotations) upotrebljavaju znakovni literal kao naznaku tipa, primjerice node: "Node" ili -> "Node". Omogućuju referenciranje klase definirane kasnije, uključujući klasu koja referencira samu sebe. To ne znači da je očekivana vrijednost tipa str.
U Pythonu 3.14 evaluacija anotacija prema zadanim se postavkama odgađa, pa je za ovu vrstu reference obično dovoljan i Node bez navodnika. Izričiti zapis "Node" ostaje valjan. To se razlikuje od from __future__ import annotations, zbog kojeg se anotacije pohranjuju kao nizovi znakova. Same naznake tipova ne nameću tipove argumenata tijekom izvođenja.
typing.get_type_hints() razrješava tekstualne reference u stvarne tipove. Pozovite je tek kada su potrebni nazivi dostupni u odgovarajućim imenskim prostorima; nerazriješeni naziv može uzrokovati NameError. Funkcija može izvršiti kod sadržan u anotacijama, stoga je nemojte upotrebljavati s anotacijama kojima ne vjerujete.
U primjeru se identity pojavljuje prije definicije Node, ali se naznake tipova pregledavaju nakon nje. Dva rezultata True prikazuju očekivano razrješenje obiju anotacija u klasu Node, a posljednji redak prikazuje naziv klase vraćenog objekta.
Primjeri
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__)
Rezultat
True True Node
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.