Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

Annotazioni di riferimenti in avanti tra virgolette

Un’annotazione come "Node" descrive un tipo usando un nome memorizzato come testo, anche quando la classe viene definita in seguito. Python 3.14 rimanda la valutazione delle annotazioni per impostazione predefinita, quindi spesso le virgolette non sono più necessarie, ma restano sintassi valida.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

def f(value: "LaterType") -> "LaterType": ...

Le annotazioni di riferimenti in avanti tra virgolette (quoted forward-reference annotations) usano un letterale stringa come indicazione di tipo, per esempio node: "Node" o -> "Node". Permettono di fare riferimento a una classe definita in seguito, compresa una classe che fa riferimento a sé stessa. Non significano che il valore atteso sia di tipo str.

In Python 3.14, la valutazione delle annotazioni è rimandata per impostazione predefinita, quindi per questo tipo di riferimento di solito basta anche Node senza virgolette. La forma esplicita "Node" resta valida. Questo è diverso da from __future__ import annotations, che fa sì che le annotazioni vengano memorizzate come stringhe. Le indicazioni di tipo, da sole, non impongono i tipi degli argomenti durante l’esecuzione.

typing.get_type_hints() risolve i riferimenti testuali in tipi effettivi. Chiamala solo quando i nomi necessari sono disponibili negli spazi dei nomi appropriati; un nome non risolto può causare un NameError. La funzione può eseguire codice contenuto nelle annotazioni, quindi non usarla con annotazioni non attendibili.

Nell’esempio, identity compare prima della definizione di Node, ma le indicazioni di tipo vengono esaminate dopo. I due risultati True mostrano la risoluzione prevista di entrambe le annotazioni nella classe Node; l’ultima riga mostra il nome della classe dell’oggetto restituito.

Esempi

from typing import get_type_hints


def identity(node: "Node") -> "Node":
    return node


class Node:
    pass


hints = get_type_hints(identity)
print(hints["node"] is Node)
print(hints["return"] is Node)
print(identity(Node()).__class__.__name__)

Risultato

True
True
Node

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti