Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources