Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Python

Dopredné odkazy v typových anotáciách

V Pythone 3.12 zapíš názov typu do úvodzoviek, ak pri definovaní metódy ešte nie je dostupný. Odkaz vyhodnoť neskôr, ak potrebuješ objekt triedy.

Verzia: Python 3.12

Syntax

# 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: ...

Dopredný odkaz v typovej anotácii odkazuje na typ, ktorého názov ešte nie je dostupný v mieste definície funkcie. V Pythone 3.12 sa bez odkladu anotácie funkcie vyhodnocujú pri vykonaní príkazu def, nie pri volaní funkcie. Ak názov typu vtedy nie je dostupný, jeho použitie bez úvodzoviek vyvolá NameError. Anotácie pomáhajú pri statickej kontrole typov; samotný Python podľa nich nekontroluje argumenty ani návratové hodnoty.

V WorkItem.from_dict odkazuje -> "WorkItem" na triedu, ktorej telo sa ešte vykonáva. V Project.add_module odkazuje module: "Module" na triedu definovanú nižšie. V oboch prípadoch reťazcový literál zaznamená odkaz bez okamžitého vyhľadania názvu. Pri zjednotení typov daj do úvodzoviek celý výraz: "int | Module". Bez odkladu vyvolá int | "Module" výnimku TypeError, pretože operátor | dostane typ a reťazec.

Ďalšou možnosťou je uviesť from __future__ import annotations na začiatok modulu, za prípadný dokumentačný reťazec. V Pythone 3.12 tento import ukladá anotácie funkcií ako reťazce, takže môžeš písať -> WorkItem a module: Module bez úvodzoviek. Neodkladá vyhodnocovanie bežných výrazov mimo anotácií, napríklad predvolených hodnôt parametrov.

V príklade obsahuje __annotations__ reťazce. Po definovaní oboch tried typing.get_type_hints() vyhľadá názvy v príslušných menných priestoroch a vyhodnotí odkazy na objekty tried. Ak názov chýba, napríklad preto, že bol importovaný len v if TYPE_CHECKING:, stále môže nastať NameError. Nevyhodnocuj nedôveryhodné anotácie: vyhodnotenie ich výrazov môže spustiť kód.

Príklady

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)

Výsledok

'WorkItem'
'Module'
True
True

Prvé dva riadky zobrazujú reprezentácie reťazcov z `__annotations__`. Dva výsledky `True` potvrdzujú, že vyhodnotené anotácie sú presne objekty tried `WorkItem` a `Module`.

Súvisiace lekcie

  • Python · Lekcia 3 · Pokročilá · Verzia: 5
  • Python · Lekcia 7 · Pokročilá · Verzia: 5

Zdroje