CKTIS / Python
functools.total_ordering
Complète les comparaisons d’ordre manquantes à partir par exemple de `__lt__` et d’une égalité `__eq__` cohérente.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
@functools.total_orderingComplète les comparaisons d’ordre manquantes à partir par exemple de __lt__ et d’une égalité __eq__ cohérente.
Une méthode générée appelle les comparaisons existantes. Par rapport à six méthodes écrites directement, elle ajoute des appels et allonge la pile. Les méthodes existantes, même héritées, sont conservées. NotImplemented pour un type étranger autorise un essai réfléchi ou TypeError.
Les rangs égaux vérifient >= et le rang 1 ne dépasse pas 3.
from functools import total_ordering
@total_ordering
class Level:
def __init__(self, n): self.n = n
def __eq__(self, other): return self.n == other.n if isinstance(other, Level) else NotImplemented
def __lt__(self, other): return self.n < other.n if isinstance(other, Level) else NotImplemented
assert Level(2) >= Level(2) and Level(3) > Level(2)
try:
Level(1) < 2
except TypeError:
pass
else:
raise AssertionError
assert Level.__lt__(Level(2), "x") is NotImplemented
Exemples
import functools
@functools.total_ordering
class Rank:
def __init__(self, value): self.value = value
def __eq__(self, other): return self.value == other.value if isinstance(other, Rank) else NotImplemented
def __lt__(self, other): return self.value < other.value if isinstance(other, Rank) else NotImplemented
print(Rank(2) >= Rank(2), Rank(1) > Rank(3))
Résultat
True False
Les rangs égaux vérifient >= et le rang 1 ne dépasse pas 3.