object.__le__

Метод для реализации «богатого» сравнения. le от англ. «less equal» — «меньше равно».

Метод может возбудить исключение NotImplemented, если сравнение для указанной пары аргументов не реализовано.
В соответствии с договорённостью в случае успешного сравнения возвращает True, либо False. Однако, может возвращать и любое другое значение, таким образом, если результат сравнения будет использован в контексте Булева типа (например, в условии if), Питон произведёт вызов bool() для интерпретации данного значения.

    class Moon:

        r = 1737.10

        def __le__(self, other):
            print('moon le')
            return self.r <= other.r


    class Earth:

        r = 6371.0

        def __le__(self, other):
            print('earth le')
            return self.r <= other.r


    my_moon = Moon()
    my_earth = Earth()

    is_le = (my_moon <= my_earth)  # moon le
    is_le  # True
    is_le = (my_earth <= my_moon)  # earth le
    is_le  # False

    is_le = (my_moon <= my_moon)  # moon le
    is_le  # True

Между различными операторами сравнения нет подразумеваемых взаимосвязей. Так истинность (x< y or x==y) не подразумевает x<=y.

Не существует «перевёрнутых» методов, которые могли бы использоваться автоматически, если левый аргумент не поддерживает вызванную операцию, а правый поддерживает. Вместо этого обычно считают зеркальными __le__() и __ge__(). +py3.4 Если операнды имеют различные типы и тип правого операнда является прямым или косвенным наследником типа левого операнда о метод-отражение правого операнда имеет приоритет, в иных случаях приоритет остаётся у метода левого операнда. При этом виртуальное наследование не учитывается.

Для автоматического генерирования операций упорядочивания по единой базовой операции можно использовать functools.total_ordering().

Для получения дополнительной важной информации об использовании «богатого сравнения» при создании объектов, поддерживающих хеширование, которые могут использоваться в качестве ключей в словарях смотрите object.__hash__().