Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje