CKTIS / Python
Typová anotácia s dopredným odkazom
V Pythone 3.12 môže typová anotácia v úvodzovkách odkazovať na názov, ktorý bude dostupný až po definovaní funkcie.
Verzia: Python 3.12
Syntax
def run_test(test: "Callable[[], None]") -> None:
test()V Pythone 3.12 sa bez from __future__ import annotations anotácie funkcie vyhodnocujú pri vykonaní príkazu def, nie pri volaní funkcie. Názov bez úvodzoviek, ktorý ešte nie je dostupný, môže vtedy vyvolať NameError. Typovú anotáciu s dopredným odkazom možno zapísať ako reťazec, napríklad "Callable[[], None]", aby sa typový výraz dal vyhodnotiť neskôr.
V signatúre run_test opisuje Callable[[], None] volateľný objekt, ktorý neprijíma žiadne argumenty ([]) a vracia None. Samostatné -> None označuje návratovú hodnotu samotnej funkcie run_test. Úvodzovky neznamenajú, že treba odovzdať reťazec, a Python automaticky nekontroluje, či argument zodpovedá anotácii.
run_test.__annotations__["test"] obsahuje reťazec. typing.get_type_hints(run_test) vyhodnotí výraz v príslušnom priestore názvov a môže vyvolať NameError, ak Callable stále nie je dostupný. Ak je Callable dostupný už pri vykonaní def, úvodzovky netreba. Nevyhodnocuj anotácie z nedôveryhodných zdrojov: vyhodnotenie výrazov v nich môže spustiť kód.
Príklady
from typing import get_type_hints
def run_test(test: "Callable[[], None]") -> None:
test()
from collections.abc import Callable # Deliberately imported after run_test.
def smoke_test() -> None:
print("Test ran", end="")
print(repr(run_test.__annotations__["test"]))
print(get_type_hints(run_test)["test"] == Callable[[], None])
run_test(smoke_test)Výsledok
'Callable[[], None]' True Test ran
Import z `collections.abc` je zámerne až za definíciou `run_test`. Prvý riadok ukazuje reprezentáciu reťazca, `True` potvrdzuje zhodu vyhodnoteného typu s očakávaným a `Test ran` vypíše zavolaná testovacia funkcia.
Súvisiace lekcie
- Python · Lekcia 26 · Základná · Verzia: 3