CKTIS / Python
typing.runtime_checkable
Permette a isinstance di controllare la presenza dei membri del protocollo senza verificarne tipi o firme.
Versione: Python 3.14; repository image, production runtime not attested
Sintassi
@runtime_checkable
class Reader(Protocol): ...Permette a isinstance di controllare la presenza dei membri del protocollo senza verificarne tipi o firme.
Da Python 3.12 la ricerca degli attributi è statica e i membri richiesti sono fissati alla creazione del protocollo. Un metodo con arità errata supera il test ma fallisce alla chiamata.
Un protocollo con un attributo dati consente isinstance ma usarlo in issubclass solleva TypeError.
Esempi
from typing import Protocol, runtime_checkable
@runtime_checkable
class Reader(Protocol):
def read(self) -> str: ...
class Wrong:
def read(self, size):
return size
candidate = Wrong()
print(isinstance(candidate, Reader))
try:
candidate.read()
except TypeError:
print("incompatible signature")
@runtime_checkable
class Tagged(Protocol):
tag: str
class Record:
tag = "shown"
assert isinstance(Record(), Tagged)
try:
issubclass(Record, Tagged)
except TypeError:
print("instance check only")
else:
raise AssertionError("unexpected subclass check")
Risultato
True incompatible signature instance check only
Un protocollo con un attributo dati consente isinstance ma usarlo in issubclass solleva TypeError.