CKTIS / Python
Le littéral `...` (`Ellipsis`) dans les méthodes de protocole
En Python 3.12, `...` est un littéral qui désigne l’objet `Ellipsis`. Dans le corps d’une méthode de protocole, il signale l’absence d’implémentation sans renvoyer cet objet.
Version : Python 3.12
Syntaxe
...
from typing import Protocol
class Reader(Protocol):
def read(self) -> int:
...Les trois points consécutifs ... forment un élément de la syntaxe Python, pas une marque éditoriale signalant du code omis. Le littéral désigne l’unique instance de types.EllipsisType, également accessible par le nom natif Ellipsis. L’opérateur is permet de vérifier qu’il s’agit du même objet.
Si ... est la seule instruction du corps d’une fonction ordinaire, c’est une instruction d’expression : sa valeur n’est pas renvoyée. En arrivant à la fin du corps, la fonction renvoie None, comme avec un pass seul. Cependant, pass est une instruction, pas une expression. À l’inverse, return ... renvoie explicitement Ellipsis.
Dans une classe fondée sur typing.Protocol, un corps réduit à ... indique que la méthode fixe une exigence de l’interface plutôt que de fournir une implémentation par défaut utilisable. Un vérificateur de types statique peut accepter une classe dont la signature de méthode est compatible, même si elle n’hérite pas du protocole. Le littéral n’applique pas @abstractmethod et ne déclenche pas de vérification des signatures à l’exécution.
Exemples
from typing import Protocol
class Reader(Protocol):
def read(self) -> int:
...
class FixedReader:
def read(self) -> int:
return 7
def read_value(reader: Reader) -> int:
return reader.read()
def placeholder() -> None:
...
print((...) is Ellipsis)
print(placeholder() is None)
print(read_value(FixedReader()))
Résultat
True True 7
Le premier `True` confirme l’identité avec `Ellipsis` ; le second montre que `placeholder()` renvoie `None`. Le `7` provient de `FixedReader.read()`, pas du corps de la méthode de protocole.
Leçons associées
- Python · Leçon 22 · Avancé · Version : 5