Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes