CKTIS / Python
Typeannotaties en protocollen
Een annotatie kan voor een statische controle een interface beschrijven zonder gedeelde basisklasse.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
class Reader(Protocol):
def read(self) -> str: ...Een annotatie kan voor een statische controle een interface beschrijven zonder gedeelde basisklasse.
Protocol beschrijft methoden en signaturen structureel. Functieaanroepen dwingen annotaties niet af. Met runtime_checkable controleert isinstance de aanwezigheid van leden zonder parameters of resultaattypen te toetsen.
Message geeft READY. NeedsKey heeft read en slaagt voor de controle, hoewel aanroepen zonder argument TypeError veroorzaakt.
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
Voorbeelden
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))
Resultaat
READY True
Message geeft READY. NeedsKey heeft read en slaagt voor de controle, hoewel aanroepen zonder argument TypeError veroorzaakt.