CKTIS / Python
typing.runtime_checkable
Permite usar isinstance para comprobar la presencia de miembros del protocolo sin validar sus tipos ni firmas.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
@runtime_checkable
class Reader(Protocol): ...Permite usar isinstance para comprobar la presencia de miembros del protocolo sin validar sus tipos ni firmas.
Desde Python 3.12 la búsqueda de atributos es estática y los miembros exigidos se fijan al crear el protocolo. Un método con aridad incorrecta supera la prueba pero falla al invocarse.
Un protocolo con un atributo de datos admite isinstance, pero usarlo en issubclass provoca TypeError.
Ejemplos
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")
Resultado
True incompatible signature instance check only
Un protocolo con un atributo de datos admite isinstance, pero usarlo en issubclass provoca TypeError.