CKTIS / Python
Adnotacja typu z odwołaniem wprzód
W Pythonie 3.12 adnotacja typu zapisana w cudzysłowie może wskazywać nazwę, która stanie się dostępna dopiero po zdefiniowaniu funkcji.
Wersja: Python 3.12
Składnia
def run_test(test: "Callable[[], None]") -> None:
test()W Pythonie 3.12 adnotacje funkcji bez from __future__ import annotations są obliczane podczas wykonywania instrukcji def, a nie podczas wywołania funkcji. Niezacytowana nazwa, która nie jest jeszcze dostępna, może wtedy spowodować NameError. Adnotacja z odwołaniem wprzód zapisuje wyrażenie typu jako napis, na przykład "Callable[[], None]", żeby można je było rozwiązać później.
W sygnaturze run_test adnotacja Callable[[], None] opisuje obiekt wywoływalny, który przyjmuje zero argumentów ([]) i zwraca None. Osobne -> None dotyczy wyniku samej funkcji run_test. Cudzysłów nie oznacza, że należy przekazać napis, a Python nie sprawdza automatycznie zgodności argumentu z adnotacją.
run_test.__annotations__["test"] zawiera napis. typing.get_type_hints(run_test) oblicza wyrażenie w odpowiedniej przestrzeni nazw i może zgłosić NameError, jeśli nadal brakuje nazwy Callable. Jeśli Callable jest już dostępne w chwili wykonywania def, cudzysłów nie jest potrzebny. Nie rozwiązuj niezaufanych adnotacji: obliczanie zapisanych w nich wyrażeń może wykonać kod.
Przykłady
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)Wynik
'Callable[[], None]' True Test ran
Import z `collections.abc` celowo znajduje się po definicji `run_test`. Pierwszy wiersz pokazuje reprezentację napisu, `True` potwierdza zgodność rozwiązanego typu z oczekiwanym, a `Test ran` pochodzi z wywołanej funkcji testowej.
Powiązane lekcje
- Python · Lekcja 26 · Podstawowy · Wersja: 3