Magic (Dunder) Methods

Syntax

def __method__(self, ...):

Examples

class Book:
    def __init__(self, title, author):
        self.title = title
        self.author = author

    def __str__(self):
        return f"{self.title} by {self.author}"

book = Book("Clean Code", "Robert Martin")
print(book)  # Clean Code by Robert Martin (uses __str__)

class Book:
    def __init__(self, title, pages):
        self.title = title
        self.pages = pages

    def __eq__(self, other):
        return self.pages == other.pages

    def __lt__(self, other):
        return self.pages < other.pages

a = Book("Book A", 200)
b = Book("Book B", 350)

print(a == b)  # False
print(a < b)   # True
print(sorted([b, a], key=lambda book: book.pages))

class Playlist:
    def __init__(self, songs):
        self.songs = songs

    def __len__(self):
        return len(self.songs)

    def __getitem__(self, index):
        return self.songs[index]

playlist = Playlist(["Song A", "Song B", "Song C"])
print(len(playlist))     # 3
print(playlist[1])       # Song B

class Vector:
    def __init__(self, x, y):
        self.x = x
        self.y = y

    def __add__(self, other):
        return Vector(self.x + other.x, self.y + other.y)

    def __repr__(self):
        return f"Vector({self.x}, {self.y})"

v1 = Vector(1, 2)
v2 = Vector(3, 4)
print(v1 + v2)  # Vector(4, 6)

Best practices

• Implement __repr__ (for developers/debugging) alongside __str__ (for end users) - __repr__ should ideally be unambiguous enough to recreate the object
• Only implement the dunder methods that genuinely make sense for your class - not every class needs __add__ or __lt__
• When you implement __eq__, consider also implementing __hash__ if instances need to be used in sets or as dictionary keys
• Use functools.total_ordering to get all comparison operators automatically once you have defined __eq__ and one ordering method

At a glance

Purpose

Scripting and general-purpose applications

File extension

.py

Runs in

Python interpreter

Usually used with

Python standard library and packages

Specifications & further reading

• Python language reference

Related Python documentation