Python __ge__() Magic Method

Short summary:

  • To customize the behavior of the greather than or equal to operator x >= y, override the __ge__() dunder method in your class definition.
  • Python internally calls x.__ge__(y) to obtain a return value when comparing two objects using x >= y.
  • The return value can be any data type because any value can automatically converted to a Boolean by using the bool() built-in function.
  • If the __ge__() method is not defined, Python will raise a TypeError.

Syntax

__ge__(self, other)

To use the greater than or equal to operator on custom objects, define the __ge__() “dunder” magic method that takes two arguments: self and other. You can then use attributes of the custom objects to determine if one is greater than or equal to the other.

The method should return a Boolean True or False — however, this is not required because every object can be automatically converted to a Boolean value using the built-in bool() function.

Let’s have a look at an example next.

Example

In the following code, you compare two persons with each other by using the age attribute as a decision criterion:

class Person:
    def __init__(self, age):
        self.age = age

    def __ge__(self, other):
        return self.age >= other.age



alice = Person(18)
bob = Person(17)
carl = Person(18)

print(alice >= bob)
# True

print(alice >= carl)
# True

print(bob >= alice)
# False

For example, because Alice’s age is 18 years and Bob’s 17 years, the expression alice >= bob evaluates to True.

Background Video

Default Implementation of __ge__

The __ge__() dunder method doesn’t have a default implementation. If you try to compare objects using the greater than or equal to operator >=, Python will simply raise a TypeError.

class Person:
    def __init__(self, age):
        self.age = age


alice = Person(18)
bob = Person(17)
carl = Person(18)

print(alice >= bob)
Traceback (most recent call last):
  File "C:\Users\xcent\Desktop\code.py", line 12, in <module>
    print(alice >= bob)
TypeError: '>=' not supported between instances of 'Person' and 'Person'

TypeError: ‘>=’ not supported between instances of ‘…’ and ‘…’

If you get the TypeError: '>=' not supported between instances of '...' and '...', you try to compare two objects using the greater than or equal to operator x >= y for which the __ge__() magic method is not defined.

class Finxter:
    pass


x = Finxter()
y = Finxter()

x >= y    # Python will raise an error!

Output:

Traceback (most recent call last):
  File "C:\Users\xcent\Desktop\code.py", line 8, in <module>
    x >= y    # Python will raise an error!
TypeError: '>=' not supported between instances of 'Finxter' and 'Finxter'

To fix the error, simply define the __ge__(self, other) method in your class definition and return any object that will then be converted to a Boolean True or False.

class Finxter:
    def __ge__(self, other):
        return 42


x = Finxter()
y = Finxter()

x >= y    # Now it works!
# 42

Commutativity of Greater Than or Equal To >=

The output of x >= y and y >= x may be different because the former calls x.__ge__(y) and the latter calls y.__ge__(x). If x and y have different definitions of the dunder method __ge__(), the operation becomes non-commutative.

You can see this in the following example:

class Person:
    def __ge__(self, other):
        return False


class Human:
    def __ge__(self, other):
        return True


alice = Person()
bob = Human()


print(alice >= bob)
# False

print(bob >= alice)
# True

Where to Go From Here?

Enough theory, let’s get some practice!

To become successful in coding, you need to get out there and solve real problems for real people. That’s how you can become a six-figure earner easily. And that’s how you polish the skills you really need in practice. After all, what’s the use of learning theory that nobody ever needs?

Practice projects is how you sharpen your saw in coding!

Do you want to become a code master by focusing on practical code projects that actually earn you money and solve problems for people?

Then become a Python freelance developer! It’s the best way of approaching the task of improving your Python skills—even if you are a complete beginner.

Join my free webinar “How to Build Your High-Income Skill Python” and watch how I grew my coding business online and how you can, too—from the comfort of your own home.

Join the free webinar now!