CKTIS / Python
typing.runtime_checkable
Permet à isinstance de vérifier la présence des membres du protocole sans contrôler leurs types ni signatures.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
@runtime_checkable
class Reader(Protocol): ...Permet à isinstance de vérifier la présence des membres du protocole sans contrôler leurs types ni signatures.
Depuis Python 3.12 la recherche d’attributs est statique et les membres requis sont fixés à la création du protocole. Une méthode au nombre de paramètres incorrect réussit le test mais échoue à l’appel.
Un protocole avec un attribut de données accepte isinstance, mais l’utiliser dans issubclass lève TypeError.
Exemples
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")
Résultat
True incompatible signature instance check only
Un protocole avec un attribut de données accepte isinstance, mais l’utiliser dans issubclass lève TypeError.