Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti