База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

typing.runtime_checkable

Позволява на isinstance да провери присъствието на членове на протокола без проверка на типове и сигнатури.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

@runtime_checkable
class Reader(Protocol): ...

Позволява на isinstance да провери присъствието на членове на протокола без проверка на типове и сигнатури.

От Python 3.12 търсенето на атрибути е статично, а необходимите членове се фиксират при създаване на протокола. Метод с грешен брой параметри минава проверката, но извикването се проваля.

Протокол с атрибут за данни поддържа isinstance, но използването му в issubclass предизвиква TypeError.

Примери

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")

Резултат

True
incompatible signature
instance check only

Протокол с атрибут за данни поддържа isinstance, но използването му в issubclass предизвиква TypeError.

Източници