Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori