CKTIS / Python
Sklici naprej v tipskih opombah
V Pythonu 3.12 zapiši ime tipa v narekovajih, če ob definiciji metode še ni na voljo. Sklic razreši pozneje, če potrebuješ objekt razreda.
Različica: 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: ...Sklic naprej v tipski opombi se nanaša na tip, katerega ime na mestu definicije funkcije še ni na voljo. V Pythonu 3.12 se brez odloženega vrednotenja opombe funkcije ovrednotijo ob izvedbi stavka def, ne ob klicu funkcije. Če ime tipa takrat ni na voljo, njegova uporaba brez narekovajev sproži NameError. Opombe pomagajo orodjem za statično preverjanje tipov; Python sam z njimi ne preverja argumentov ali vrnjenih vrednosti.
V WorkItem.from_dict se -> "WorkItem" sklicuje na razred, katerega telo se še izvaja. V Project.add_module se module: "Module" sklicuje na razred, definiran nižje. V obeh primerih nizovni literal zabeleži sklic, ne da bi takoj poiskal ime. Pri uniji tipov daj v narekovaje celoten izraz: "int | Module". Brez odloženega vrednotenja int | "Module" sproži TypeError, ker operator | prejme tip in niz.
Druga možnost je, da from __future__ import annotations postaviš na začetek modula, za morebitni dokumentacijski niz. V Pythonu 3.12 ta uvoz shrani opombe funkcij kot nize, zato lahko zapišeš -> WorkItem in module: Module brez narekovajev. Ne odloži vrednotenja običajnih izrazov zunaj opomb, na primer privzetih vrednosti parametrov.
V primeru __annotations__ vsebuje nize. Ko sta oba razreda definirana, typing.get_type_hints() poišče imena v ustreznih imenskih prostorih in razreši sklice do objektov razredov. Če ime manjka, na primer ker je bilo uvoženo samo v if TYPE_CHECKING:, lahko še vedno pride do NameError. Ne razrešuj opomb iz nezaupanja vrednih virov: vrednotenje njihovih izrazov lahko izvede kodo.
Primeri
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
Prvi dve vrstici prikažeta predstavitvi nizov iz `__annotations__`. Rezultata `True` potrdita, da sta razrešeni opombi prav objekta razredov `WorkItem` in `Module`.
Povezane lekcije
- Python · Lekcija 3 · Napredna · Različica: 5
- Python · Lekcija 7 · Napredna · Različica: 5