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

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.

Sources