CKTIS / Python
Annotazione di tipo con riferimento in avanti
In Python 3.12, un’annotazione di tipo tra virgolette può riferirsi a un nome che diventa disponibile solo dopo la definizione della funzione.
Versione: Python 3.12
Sintassi
def run_test(test: "Callable[[], None]") -> None:
test()In Python 3.12, senza from __future__ import annotations, le annotazioni di una funzione vengono valutate quando si esegue l’istruzione def, non quando si chiama la funzione. Un nome senza virgolette che non è ancora disponibile può causare NameError in quel momento. Un’annotazione con riferimento in avanti può essere scritta come stringa, per esempio "Callable[[], None]", per risolvere l’espressione di tipo in seguito.
Nella firma di run_test, Callable[[], None] descrive un oggetto invocabile che non accetta argomenti ([]) e restituisce None. Il -> None separato indica cosa restituisce run_test stessa. Le virgolette non indicano che si debba passare una stringa, e Python non controlla automaticamente che l’argomento rispetti l’annotazione.
run_test.__annotations__["test"] contiene la stringa. typing.get_type_hints(run_test) valuta l’espressione nello spazio dei nomi appropriato e può sollevare NameError se Callable non è ancora disponibile. Se Callable è già disponibile quando si esegue def, le virgolette non servono. Non risolvere annotazioni da fonti non attendibili: valutare le espressioni che contengono può eseguire codice.
Esempi
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)Risultato
'Callable[[], None]' True Test ran
L’importazione da `collections.abc` è posta appositamente dopo la definizione di `run_test`. La prima riga mostra la rappresentazione della stringa, `True` conferma che il tipo risolto coincide con quello atteso e `Test ran` è stampato dalla funzione di test invocata.
Lezioni correlate
- Python · Lezione 26 · Base · Versione: 3