A. Reit photo

A. Reit

Introducing the Spyder-Watchlist plugin

Spyder's Variable Explorer is a great tool which aids the development and debugging of Python code by displaying all variables from the current scope. One thing the Variable Explorer is missing is the ability to display the value of arbitrary, user-definable expressions while debugging. For example, it might be useful to see the value of a specific attribute of an object, or the value of an array at some index. Such a feature is known as a "watchlist" or "watches" in other Integrated Development Environments (IDEs). This blog post introduces the Watchlist plugin developed for Spyder.


The watchlist consists of a user-definable list of expressions. They are evaluated after each debugger step, and the result of the evaluation is displayed as a string. This means that value = str(eval(expression)) is performed behind the scenes, and the result is shown in the plugin. The watchlist is a very powerful tool, but this comes at a cost: Any side effect of an expression will affect the execution environment.

Expressions can be added, removed and modified at any time. The value of an invalid expression is shown as <exception name>. You can hover the mouse over the value to show the full exception message in a tooltip. Values which have changed with the most recent debugger step are shown with a bold font, so you can recognise them more easily.

A picture is worth a thousand words, as they say, so here is a whole screencast of the Watchlist plugin in action:

Installation and going forwards

For conda or pip-installed Spyder, the plugin can be installed by running the following with your Spyder environment activated:

pip install spyder-watchlist

Feel free to send your ideas, bug reports and pull requests to the spyder-watchlist repository on GitHub.


Open Chat