Skip to content Skip to sidebar Skip to footer

When I Am In The Python Or IPython Console, What Is Called When I Am Returned An Output?

For example, python >> x = 1 >> x 1 I'm curious about what method/function on x is returning 1. I'm asking because I'm seeing differences between calling print x and

Solution 1:

When you inspect an object in that manner in a REPL, it invokes the object's __repr__ method. In comparison, print uses the object's __str__ method. Example:

>>> class Widget:
...     def __repr__(self):
...             return "repr of a Widget"
...     def __str__(self):
...             return "str of a Widget"
...
>>> x = Widget()
>>> x
repr of a Widget
>>> print(x)
str of a Widget
>>> print([x,2,3])
[repr of a Widget, 2, 3]
>>> print(repr(x))
repr of a Widget
>>> print(str(x))
str of a Widget

When defining __repr__ and __str__ for your own classes, try to follow the documentation's suggestions regarding which one should be more detailed and "official".

[__repr__ computes] the “official” string representation of an object. If at all possible, this should look like a valid Python expression that could be used to recreate an object with the same value (given an appropriate environment).
...
[__str__ computes] the “informal” string representation of an object. The return value must be a string object. This method differs from object.__repr__() in that there is no expectation that __str__() return a valid Python expression: a more convenient or concise representation can be used.


Solution 2:

The other answer addresses repr in a vanilla Python REPL, but it neglected to answer about IPython, which works quite differently and has many more features (and complexity) in regards to REPL printing.

Here's an example discrepancy:

# vanilla python:
>>> type([])
<class 'list'>

# in IPython:
>>> type([])
list

IPython has a custom pretty printer and public hooks for customizing repr within IPython. One such hook is _repr_pretty_ (single underscores!) and here's a basic example:

>>> class Widget:
...     def __repr__(self):
...         "vanilla"
...     def _repr_pretty_(self, p, cycle):
...         p.text("chocolate, strawberry")
...         
>>> Widget()
chocolate, strawberry

For more features, see "Integrating your objects with IPython" in the docs, in particular the Rich display section.


Post a Comment for "When I Am In The Python Or IPython Console, What Is Called When I Am Returned An Output?"