Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła