Difference between str and repr

Question

What is the difference between __str__ and __repr__ in Python?

Answer 1

• The default implementation is useless (it’s hard to think of one which wouldn’t be, but yeah)
• __repr__ goal is to be unambiguous
• __str__ goal is to be readable
• Container’s __str__ uses contained objects’ __repr__

A default implementation is useless

This is mostly a surprise because Python’s defaults tend to be fairly useful. However, in this case, having a default for __repr__ which would act like:

return "%s(%r)" % (self.__class__, self.__dict__)

would have been too dangerous (for example, too easy to get into an infinite recursion if objects reference each other). So Python cops out. Note that there is one default which is true: if __repr__ is defined, and __str__ is not, the object will behave as though __str__=__repr__.

This means, in simple terms: almost every object you implement should have a functional __repr__ that’s usable for understanding the object. Implementing __str__ is optional: do that if you need a “pretty print” functionality (for example, used by a report generator).