TL; DR : Jeśli używasz Pythona 3.10 lub nowszego, to po prostu działa. Od dzisiaj (2019) w wersji 3.7+ musisz włączyć tę funkcję używając wyrażenia future (from __future__ import annotations) - dla Pythona 3.6 lub poniżej użyj ciągu znaków.

Chyba masz ten wyjątek:

NameError: name 'Position' is not defined

To dlatego, że Position musi być zdefiniowany, zanim będzie można go użyć w adnotacji, chyba że używasz Pythona 3.10 lub nowszego.

Python 3.7+: from __future__ import annotations

Python 3.7 wprowadza PEP 563: przełożona ocena adnotacje . Moduł, który używa wyrażenia future from __future__ import annotations będzie automatycznie zapisywał adnotacje jako ciągi znaków:

from __future__ import annotations

class Position:
    def __add__(self, other: Position) -> Position:
        ...

To ma być domyślne w Pythonie 3.10. Ponieważ Python nadal jest językiem dynamicznie wpisywanym, więc nie sprawdzanie typu jest wykonywane w czasie wykonywania, wpisywanie adnotacji nie powinno mieć wpływu na wydajność, prawda? Źle! Przed Pythonem 3.7 moduł typowania był jednym z najwolniejszych modułów Pythona w core więc jeśli {[16] } zobaczysz w górę do 7-krotnego wzrostu wydajności Po uaktualnieniu do wersji 3.7.

Python

Zgodnie z PEP 484, powinieneś użyć ciągu znaków zamiast samej klasy:

class Position:
    ...
    def __add__(self, other: 'Position') -> 'Position':
       ...

Jeśli używasz frameworka Django, może to być znane, ponieważ modele Django również używają łańcuchów do przekazywania referencji (definicje klucza obcego, gdzie model obcy jest self lub nie jest jeszcze zadeklarowany). Powinno to działać z Pycharm i innymi narzędzia.

Źródła

Odpowiednie części PEP 484 i PEP 563, aby oszczędzić Ci podróży:

Forward references

Gdy podpowiedź typu zawiera nazwy, które nie zostały jeszcze zdefiniowane, definicja ta może być wyrażona jako literał Łańcuchowy, który zostanie rozwiązany później.

Sytuacja, w której występuje to powszechnie, to definicja klasy kontenera, w której zdefiniowana Klasa występuje w podpisie niektórych z metody. Na przykład następujący kod (początek prostej implementacji drzewa binarnego) nie działa:

class Tree:
    def __init__(self, left: Tree, right: Tree):
        self.left = left
        self.right = right

Aby się tym zająć, piszemy:

class Tree:
    def __init__(self, left: 'Tree', right: 'Tree'):
        self.left = left
        self.right = right

Łańcuch znaków powinien zawierać poprawne wyrażenie Pythona (tzn. compile(lit, ", 'eval') powinien być prawidłowym obiektem kodu) i powinien być oceniany bez błędów po pełnym załadowaniu modułu. Lokalna i globalna przestrzeń nazw, w której jest oceniana, powinny być tymi samymi przestrzeniami nazw, w których domyślne argumenty tej samej funkcji będą oceniane.

I PEP 563:

W Pythonie 3.10 adnotacje funkcji i zmiennych nie będą już oceniane w czasie definiowania. Zamiast tego, w odpowiednim słowniku __annotations__ zachowana zostanie forma łańcuchowa. Statyczne Kontrolery typów nie będą widzieć różnicy w zachowaniu, podczas gdy narzędzia wykorzystujące adnotacje w czasie wykonywania będą musiały wykonać przełożoną ocenę.

...

The funkcjonalność opisana powyżej może być włączona począwszy od Pythona 3.7 przy użyciu następującego specjalnego importu:

from __future__ import annotations

Rzeczy, które możesz pokusić się o zamiast tego

A. Zdefiniuj manekina Position

Przed definicją klasy umieść atrapę definicji:

class Position(object):
    pass


class Position(object):
    ...

To pozbędzie się NameError i może nawet wyglądać OK:

>>> Position.__add__.__annotations__
{'other': __main__.Position, 'return': __main__.Position}

>>> for k, v in Position.__add__.__annotations__.items():
...     print(k, 'is Position:', v is Position)                                                                                                                                                                                                                  
return is Position: False
other is Position: False

B. małpa-łatka w celu dodania adnotacji:

Możesz spróbować Meta Pythona programowanie magii i pisanie dekoratora aby dodać adnotacje do definicji klasy:

class Position:
    ...
    def __add__(self, other):
        return self.__class__(self.x + other.x, self.y + other.y)

Dekorator powinien być odpowiedzialny za odpowiednik tego:

Position.__add__.__annotations__['return'] = Position
Position.__add__.__annotations__['other'] = Position

Przynajmniej wydaje się słuszne:

>>> for k, v in Position.__add__.__annotations__.items():
...     print(k, 'is Position:', v is Position)                                                                                                                                                                                                                  
return is Position: True
other is Position: True

Podsumowanie

Jeśli używasz 3.6 lub poniżej, użyj literału zawierającego nazwę klasy, w 3.7 użyj {[12] } i to po prostu zadziała.