CKTIS / Python
Riferimenti anticipati nelle annotazioni di tipo
In Python 3.12, racchiudi tra virgolette il nome di un tipo non ancora disponibile quando definisci un metodo. Risolvi il riferimento in seguito se ti serve l’oggetto classe.
Versione: Python 3.12
Sintassi
# Quote a name that is not bound yet:
def f(value: "Later") -> "Later": ...
# For a union, quote the entire expression:
def g(value: "int | Later") -> None: ...
# Alternatively, as a separate module using postponed evaluation:
from __future__ import annotations
def f(value: Later) -> Later: ...Un riferimento anticipato in un’annotazione di tipo indica un tipo il cui nome non è ancora disponibile nel punto in cui si definisce la funzione. In Python 3.12, senza valutazione posticipata, le annotazioni di funzione vengono valutate quando viene eseguita l’istruzione def, non alla chiamata. Se il nome del tipo non è ancora disponibile, usarlo senza virgolette causa NameError. Le annotazioni aiutano gli strumenti di controllo statico; Python non le usa per verificare gli argomenti o i valori restituiti.
In WorkItem.from_dict, -> "WorkItem" si riferisce alla classe il cui corpo è ancora in esecuzione. In Project.add_module, module: "Module" indica una classe definita più avanti. In entrambi i casi, la stringa letterale registra il riferimento senza cercare subito il nome. Per un’unione, racchiudi tra virgolette l’intera espressione: "int | Module". Senza valutazione posticipata, int | "Module" causa TypeError perché | riceve un tipo e una stringa.
In alternativa, inserisci from __future__ import annotations all’inizio del modulo, dopo l’eventuale docstring. In Python 3.12, questa importazione conserva le annotazioni di funzione come stringhe, quindi puoi scrivere -> WorkItem e module: Module senza virgolette. Non rinvia la valutazione delle normali espressioni al di fuori delle annotazioni, come i valori predefiniti dei parametri.
Nell’esempio, __annotations__ contiene stringhe. Una volta definite entrambe le classi, typing.get_type_hints() cerca i nomi negli spazi dei nomi pertinenti e risolve i riferimenti negli oggetti classe. Se manca un nome, per esempio perché è stato importato solo in if TYPE_CHECKING:, può ancora verificarsi NameError. Non risolvere annotazioni non attendibili: valutarne le espressioni può eseguire codice.
Esempi
from typing import get_type_hints
class WorkItem:
def __init__(self, title: str) -> None:
self.title = title
@classmethod
def from_dict(cls, data: dict[str, str]) -> "WorkItem":
return cls(data["title"])
class Project:
def __init__(self) -> None:
self.modules = []
def add_module(self, module: "Module") -> None:
self.modules.append(module)
class Module:
pass
print(repr(WorkItem.from_dict.__annotations__["return"]))
print(repr(Project.add_module.__annotations__["module"]))
print(get_type_hints(WorkItem.from_dict)["return"] is WorkItem)
print(get_type_hints(Project.add_module)["module"] is Module)
Risultato
'WorkItem' 'Module' True True
Le prime due righe mostrano le rappresentazioni delle stringhe in `__annotations__`. I due risultati `True` confermano che le annotazioni risolte sono esattamente gli oggetti classe `WorkItem` e `Module`.
Lezioni correlate
- Python · Lezione 3 · Avanzato · Versione: 5
- Python · Lezione 7 · Avanzato · Versione: 5