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

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

Zdroje