CKTIS / Python
Unaprijedne reference u anotacijama tipova
U Pythonu 3.12 stavi ime tipa u navodnike ako još nije dostupno pri definiranju metode. Referencu razriješi poslije ako ti treba objekt klase.
Verzija: Python 3.12
Sintaksa
# Quote a name that is not bound yet:
def f(value: "Later") -> "Later": ...
# For a union, quote the entire expression:
def g(value: "int | Later") -> None: ...
# Alternatively, as a separate module using postponed evaluation:
from __future__ import annotations
def f(value: Later) -> Later: ...Unaprijedna referenca u anotaciji tipa upućuje na tip čije ime još nije dostupno na mjestu definiranja funkcije. U Pythonu 3.12, bez odgođenog vrednovanja, anotacije funkcije vrednuju se pri izvršavanju naredbe def, a ne pri pozivu funkcije. Ako ime tipa tada nije dostupno, njegova uporaba bez navodnika izaziva NameError. Anotacije pomažu alatima za statičku provjeru tipova; sam Python ne provjerava argumente ni povratne vrijednosti prema njima.
U WorkItem.from_dict anotacija -> "WorkItem" upućuje na klasu čije se tijelo još izvršava. U Project.add_module anotacija module: "Module" upućuje na klasu definiranu niže. U oba slučaja literal znakovnog niza bilježi referencu bez trenutnog traženja imena. Za uniju tipova stavi cijeli izraz u navodnike: "int | Module". Bez odgođenog vrednovanja int | "Module" izaziva TypeError jer operator | dobiva tip i znakovni niz.
Druga je mogućnost staviti from __future__ import annotations na početak modula, nakon dokumentacijskog niza ako postoji. U Pythonu 3.12 taj uvoz pohranjuje anotacije funkcija kao znakovne nizove, pa možeš pisati -> WorkItem i module: Module bez navodnika. Ne odgađa vrednovanje običnih izraza izvan anotacija, primjerice zadanih vrijednosti parametara.
U primjeru __annotations__ sadržava znakovne nizove. Nakon što su obje klase definirane, typing.get_type_hints() traži imena u odgovarajućim prostorima imena i razrješava reference u objekte klasa. Ako ime nedostaje, primjerice zato što je uvezeno samo unutar if TYPE_CHECKING:, i dalje može doći do pogreške NameError. Ne razrješavaj nepouzdane anotacije: vrednovanje njihovih izraza može izvršiti kôd.
Primjeri
from typing import get_type_hints
class WorkItem:
def __init__(self, title: str) -> None:
self.title = title
@classmethod
def from_dict(cls, data: dict[str, str]) -> "WorkItem":
return cls(data["title"])
class Project:
def __init__(self) -> None:
self.modules = []
def add_module(self, module: "Module") -> None:
self.modules.append(module)
class Module:
pass
print(repr(WorkItem.from_dict.__annotations__["return"]))
print(repr(Project.add_module.__annotations__["module"]))
print(get_type_hints(WorkItem.from_dict)["return"] is WorkItem)
print(get_type_hints(Project.add_module)["module"] is Module)
Rezultat
'WorkItem' 'Module' True True
Prva dva retka prikazuju reprezentacije znakovnih nizova iz `__annotations__`. Dva rezultata `True` potvrđuju da su razriješene anotacije upravo objekti klasa `WorkItem` i `Module`.
Povezane lekcije
- Python · Lekcija 3 · Napredno · Verzija: 5
- Python · Lekcija 7 · Napredno · Verzija: 5