CKTIS / Python
Annotations de types et protocoles
Une annotation peut décrire l’interface attendue par l’analyse statique sans imposer de classe de base commune.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
class Reader(Protocol):
def read(self) -> str: ...Une annotation peut décrire l’interface attendue par l’analyse statique sans imposer de classe de base commune.
Protocol décrit structurellement les méthodes et leurs signatures. L’appel n’impose pas les annotations. runtime_checkable autorise isinstance à vérifier la présence des membres sans vérifier paramètres ni résultat.
Message donne READY. NeedsKey possède read et passe la vérification, bien qu’un appel sans argument lève TypeError.
from typing import Protocol,runtime_checkable,get_type_hints
@runtime_checkable
class Reader(Protocol):
def read(self)->str: ...
class Bad:
def read(self, extra): return extra
def display(source:Reader): return source.read()
assert get_type_hints(display)['source'] is Reader
assert isinstance(Bad(),Reader)
try: display(Bad())
except TypeError: pass
else: raise AssertionError
Exemples
from typing import Protocol, runtime_checkable
@runtime_checkable
class Reader(Protocol):
def read(self) -> str: ...
class Message:
def read(self) -> str:
return "ready"
class NeedsKey:
def read(self, key):
return key
def display(source: Reader):
return source.read().upper()
print(display(Message()), isinstance(NeedsKey(), Reader))
Résultat
READY True
Message donne READY. NeedsKey possède read et passe la vérification, bien qu’un appel sans argument lève TypeError.