Nome non definito nell'annotazione del tipo

Question

Attualmente sto lavorando alla creazione di un modulo di algebra lineare python per il divertimento e la pratica con la lingua. Recentemente ho provato ad aggiungere annotazioni di tipo al modulo, come ad esempio:

class Vector: 
    # Various irrelevant implementation details 
    def __add__(self, other: Vector) -> Vector: 
     # More implementation details.... 

Tuttavia, quando provo ad importare questo, sputa fuori un NameError: Name 'Vector' is not defined. Riconosco che questa domanda ha già ricevuto risposta, in un modulo, here, ma non sembra fornire una risposta completa alla mia situazione.

Che mi piacerebbe sapere:

• Ho definito la classe letteralmente in questo file. Perché dice che il nome non è definito?
• Come si definisce Vector in modo che possa essere utilizzato per le annotazioni (come type)?

Answer 1

Hai una dichiarazione in avanti; le funzioni (da associare come metodi) vengono create prima della classe, quindi il nome Vector non esiste ancora. Solo quando tutto il corpo della classe è stato eseguito, Python può creare l'oggetto class e associare il nome Vector ad esso.

Basta utilizzare una stringa con il nome invece:

class Vector: 
    # Various irrelevant implementation details 
    def __add__(self, other: 'Vector') -> 'Vector': 
     # More implementation details.... 

questo non influisce come il vostro IDE vede la dichiarazione; le stringhe vengono cercate una volta caricato l'intero modulo e vengono risolte come un'espressione Python valida nel contesto corrente. Poiché la classe Vector esiste una volta caricato l'intero modulo, la stringa 'Vector' può essere correttamente convertita nell'oggetto classe.

vedere anche la specification on forward references:

Quando un tipo di suggerimento contiene i nomi che non sono state ancora definite, tale definizione può essere espresso come una stringa letterale, da risolvere in seguito.

[...]

La stringa letterale dovrebbe contenere un'espressione Python valida [...] e dovrebbe valutare senza errori una volta che il modulo è stato completamente caricato.

Answer 2

Se si utilizza Python 3.7 e superiori. Date un'occhiata a Postponed evaluation of annotations

Dal Python 3.7, sarà consentito, basta aggiungere:

from __future__ import annotations 

e si noti anche che

che diventerà il default in Python 4.0.