CKTIS / Python
typing.runtime_checkable
Permite a isinstance verificar a presença dos membros do protocolo sem validar tipos nem assinaturas.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
@runtime_checkable
class Reader(Protocol): ...Permite a isinstance verificar a presença dos membros do protocolo sem validar tipos nem assinaturas.
Desde Python 3.12 a pesquisa de atributos é estática e os membros exigidos são fixados na criação do protocolo. Um método com número incorreto de parâmetros passa o teste mas falha na chamada.
Um protocolo com um atributo de dados permite isinstance, mas usá-lo em issubclass lança TypeError.
Exemplos
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
Um protocolo com um atributo de dados permite isinstance, mas usá-lo em issubclass lança TypeError.