CKTIS / Python
Typová anotace s dopředným odkazem
V Pythonu 3.12 může typová anotace v uvozovkách odkazovat na jméno, které bude dostupné až po definování funkce.
Verze: Python 3.12
Syntaxe
def run_test(test: "Callable[[], None]") -> None:
test()V Pythonu 3.12 se bez from __future__ import annotations anotace funkce vyhodnocují při provedení příkazu def, nikoli při volání funkce. Dosud nedostupné jméno bez uvozovek může v tu chvíli vyvolat NameError. Typová anotace s dopředným odkazem může mít podobu řetězce, například "Callable[[], None]", aby bylo možné typový výraz vyhodnotit později.
V signatuře run_test popisuje Callable[[], None] volatelný objekt, který nepřijímá žádné argumenty ([]) a vrací None. Samostatné -> None označuje návratovou hodnotu samotné funkce run_test. Uvozovky neznamenají, že se má předat řetězec, a Python automaticky nekontroluje, zda argument odpovídá anotaci.
run_test.__annotations__["test"] obsahuje řetězec. typing.get_type_hints(run_test) vyhodnotí výraz v příslušném jmenném prostoru a může vyvolat NameError, pokud Callable stále není dostupné. Pokud je Callable dostupné už při provedení def, uvozovky nejsou potřeba. Nevyhodnocuj anotace z nedůvěryhodných zdrojů: vyhodnocení výrazů v nich může spustit kód.
Pří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ýsledek
'Callable[[], None]' True Test ran
Import z `collections.abc` je záměrně až za definicí `run_test`. První řádek ukazuje reprezentaci řetězce, `True` potvrzuje, že vyhodnocený typ odpovídá očekávanému, a `Test ran` vypíše zavolaná testovací funkce.
Související lekce
- Python · Lekce 26 · Základní · Verze: 3