KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen