Nbtutor

Visualize Python code execution (line-by-line) in Jupyter Notebook cells. Inspired by Online Python Tutor

To try out nbtutor, click on the "launch binder" button above and then view the examples.

Install

Note: installing directly off this repo won't work, as we don't ship the built JavaScript and CSS assets. See more about developing below.

pip install nbtutor
jupyter nbextension install --overwrite --py nbtutor
jupyter nbextension enable --py nbtutor

conda install -c conda-forge nbtutor
jupyter nbextension install --overwrite --py nbtutor
jupyter nbextension enable --py nbtutor

First load the nbtutor IPython kernel extension at top of the Notebook by executing the following magic in a CodeCell:

%load_ext nbtutor

Then to visualize the execute of code in a CodeCell add the following magic to the top of the CodeCell and execute it again:

%%nbtutor

There are also optional arguments that can be used with the cell magic:

Reset the IPython user namespace
```
%%nbtutor -r/--reset
```
Suppress the confirmation message from -r/--reset
```
%%nbtutor -r/--reset -f/--force
```
Specify the maximum frame depth to visualize (default: 3)
```
%%nbtutor -d/--depth N
```
Specify the maximum number of elements to visualize for "sequence" type objects (default: 5)
```
%%nbtutor --max_size S
```
Step through all frames (including frames from other cells and other global scopes altogether)
```
%%nbtutor --step_all
```

Please see the CONTRIBUTING and DEVELOPMENT.md guides