CKTIS / Python
Typové anotácie a protokoly
Anotácia môže opísať rozhranie očakávané statickou kontrolou bez spoločnej základnej triedy.
Verzia: Python 3.14; repository image, production runtime not attested
Syntax
class Reader(Protocol):
def read(self) -> str: ...Anotácia môže opísať rozhranie očakávané statickou kontrolou bez spoločnej základnej triedy.
Protocol opisuje metódy a ich signatúry štrukturálne. Volanie funkcie anotácie nevynucuje. runtime_checkable umožní isinstance overiť prítomnosť členov bez kontroly parametrov či návratového typu.
Message dá READY. NeedsKey má read a prejde kontrolou, hoci volanie bez argumentu vyvolá TypeError.
from typing import Protocol,runtime_checkable,get_type_hints
@runtime_checkable
class Reader(Protocol):
def read(self)->str: ...
class Bad:
def read(self, extra): return extra
def display(source:Reader): return source.read()
assert get_type_hints(display)['source'] is Reader
assert isinstance(Bad(),Reader)
try: display(Bad())
except TypeError: pass
else: raise AssertionError
Príklady
from typing import Protocol, runtime_checkable
@runtime_checkable
class Reader(Protocol):
def read(self) -> str: ...
class Message:
def read(self) -> str:
return "ready"
class NeedsKey:
def read(self, key):
return key
def display(source: Reader):
return source.read().upper()
print(display(Message()), isinstance(NeedsKey(), Reader))
Výsledok
READY True
Message dá READY. NeedsKey má read a prejde kontrolou, hoci volanie bez argumentu vyvolá TypeError.