Intro to “Dunder” Methods in Python

When learning Python, one thing I learned that was different in other languages are the double underscore (“dunder”, magic, or special) methods that can be used in classes. There are definitely ways to do this in other languages, but python makes the process a lot easier.

A class can implement certain operations that are invoked by special syntax (such as arithmetic operations or subscripting and slicing) by defining methods with special names. This is Python’s approach to operator overloading, allowing classes to define their own behavior with respect to language operators.

— Python’s documentation on what are ‘dunder’ methods

Below I have an example Pet class with the most-used dunder methods.


This was is very similar to constructor in other languages. It is what happens when the class is initialized. So in the example, we are adding a name and a species.


This is usually used for debugging purposes, Python classifies this as “[a] built-in function to compute the “official” string representation of an object. […] This is typically used for debugging, so it is important that the representation is information-rich and unambiguous.”

So, when you call it will return .


The python docs consider this, “to compute the “informal” or nicely printable string representation of an object.” So while repr is for developer purposes, this is what is normally seen by the user of the application.

When you call it will return .


This is what happens if someone tries to add two of the same classes together. The highest-level example I can provide is . Maybe there is a reason why you would want something like this in your classes (hint: spoiler for later).

When you call it will return .


This mehtod is called when the instance is about to be destroyed. In the case above, when is ran, then the system will print .

A real life application

Taking a look inside the source code for the datetime module, there is a __add__ method for the timedelta class.

A picture of the code is listed below, but what it is doing firstly is checking if both sides are a timedelta format (if it is not then it will raise a NotImplemented error) and then added the two dates together.

How the datetime module adds two dates together

Additional resources:

Final notes…

Is there anything I missed? Any additional resources you want added to this page? Comment down below to help out!



Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store