Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti