WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Typannotationen und Protokolle

Eine Annotation kann für die statische Prüfung eine Schnittstelle ohne gemeinsame Basisklasse beschreiben.

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

Syntax

class Reader(Protocol):
    def read(self) -> str: ...

Eine Annotation kann für die statische Prüfung eine Schnittstelle ohne gemeinsame Basisklasse beschreiben.

Protocol beschreibt Methoden und Signaturen strukturell. Funktionsaufrufe erzwingen Annotationen nicht. runtime_checkable erlaubt isinstance auf vorhandene Mitglieder, ohne Parameter oder Ergebnistyp zu prüfen.

Message ergibt READY. NeedsKey besteht die Prüfung auf read, obwohl ein Aufruf ohne Argument TypeError auslöst.

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

Beispiele

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))

Ergebnis

READY True

Message ergibt READY. NeedsKey besteht die Prüfung auf read, obwohl ein Aufruf ohne Argument TypeError auslöst.

Quellen